diff --git a/README.md b/README.md
index 3b9fa4a..5e59deb 100644
--- a/README.md
+++ b/README.md
@@ -193,14 +193,23 @@ Use the table above as the canonical navigation surface; every document cross-li
 ## Development workflow
 
 1. Install dependencies (Poetry or pip).
-2. Run the unit and integration suite:
+2. Run the test suite:
 
 ```bash
+# Run all tests (unit + integration)
 poetry run python3 -m pytest tests -v
+
+# Run only unit tests (skip integration tests)
+poetry run python3 -m pytest -m "not integration" -v
+
+# Run only integration tests (requires framework dependencies)
+poetry run python3 -m pytest tests/integration/ -v
 ```
 
 3. Execute targeted suites during active development, then run the full matrix before opening a pull request.
 
+**Integration Tests**: The `tests/integration/` directory contains tests that verify AgentUnit works with real framework implementations (LangGraph, etc.). These tests are automatically skipped if the required dependencies are not installed. See [tests/integration/README.md](tests/integration/README.md) for details.
+
 Latest verification (2025-10-24): 144 passed, 10 skipped, 32 warnings. Warnings originate from third-party dependencies (`langchain` pydantic shim deprecations and `datetime.utcnow` usage). Track upstream fixes or pin patched releases as needed.
 
 ## Contributing
diff --git a/poetry.lock b/poetry.lock
index 2dac127..930a833 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -420,7 +420,7 @@ description = "Foreign Function Interface for Python calling C code."
 optional = false
 python-versions = ">=3.9"
 groups = ["main"]
-markers = "python_version < \"3.14\" and platform_python_implementation != \"PyPy\""
+markers = "platform_python_implementation != \"PyPy\" and python_version < \"3.14\""
 files = [
     {file = "cffi-2.0.0-cp310-cp310-macosx_10_13_x86_64.whl", hash = "sha256:0cf2d91ecc3fcc0625c2c530fe004f82c110405f101548512cce44322fa8ac44"},
     {file = "cffi-2.0.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:f73b96c41e3b2adedc34a7356e64c8eb96e03a3782b535e043a986276ce12a49"},
@@ -955,9 +955,10 @@ test-randomorder = ["pytest-randomly"]
 name = "dataclasses-json"
 version = "0.6.7"
 description = "Easily serialize dataclasses to and from JSON."
-optional = false
+optional = true
 python-versions = "<4.0,>=3.7"
 groups = ["main"]
+markers = "extra == \"ragas\""
 files = [
     {file = "dataclasses_json-0.6.7-py3-none-any.whl", hash = "sha256:0dbf33f26c8d5305befd61b39d2b3414e8a407bedc2834dea9b8d642666fb40a"},
     {file = "dataclasses_json-0.6.7.tar.gz", hash = "sha256:b6b3e528266ea45b9535223bc53ca645f5208833c29229e847b3f26a1cc55fc0"},
@@ -1395,7 +1396,7 @@ description = "Lightweight in-process concurrent programming"
 optional = false
 python-versions = ">=3.9"
 groups = ["main"]
-markers = "python_version < \"3.14\" and (platform_machine == \"aarch64\" or platform_machine == \"ppc64le\" or platform_machine == \"x86_64\" or platform_machine == \"amd64\" or platform_machine == \"AMD64\" or platform_machine == \"win32\" or platform_machine == \"WIN32\")"
+markers = "(platform_machine == \"aarch64\" or platform_machine == \"ppc64le\" or platform_machine == \"x86_64\" or platform_machine == \"amd64\" or platform_machine == \"AMD64\" or platform_machine == \"win32\" or platform_machine == \"WIN32\") and python_version < \"3.14\""
 files = [
     {file = "greenlet-3.2.4-cp310-cp310-macosx_11_0_universal2.whl", hash = "sha256:8c68325b0d0acf8d91dde4e6f930967dd52a5302cd4062932a6b2e7c2969f47c"},
     {file = "greenlet-3.2.4-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:94385f101946790ae13da500603491f04a76b6e4c059dab271b3ce2e283b2590"},
@@ -1405,6 +1406,8 @@ files = [
     {file = "greenlet-3.2.4-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c2ca18a03a8cfb5b25bc1cbe20f3d9a4c80d8c3b13ba3df49ac3961af0b1018d"},
     {file = "greenlet-3.2.4-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:9fe0a28a7b952a21e2c062cd5756d34354117796c6d9215a87f55e38d15402c5"},
     {file = "greenlet-3.2.4-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:8854167e06950ca75b898b104b63cc646573aa5fef1353d4508ecdd1ee76254f"},
+    {file = "greenlet-3.2.4-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:f47617f698838ba98f4ff4189aef02e7343952df3a615f847bb575c3feb177a7"},
+    {file = "greenlet-3.2.4-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:af41be48a4f60429d5cad9d22175217805098a9ef7c40bfef44f7669fb9d74d8"},
     {file = "greenlet-3.2.4-cp310-cp310-win_amd64.whl", hash = "sha256:73f49b5368b5359d04e18d15828eecc1806033db5233397748f4ca813ff1056c"},
     {file = "greenlet-3.2.4-cp311-cp311-macosx_11_0_universal2.whl", hash = "sha256:96378df1de302bc38e99c3a9aa311967b7dc80ced1dcc6f171e99842987882a2"},
     {file = "greenlet-3.2.4-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:1ee8fae0519a337f2329cb78bd7a8e128ec0f881073d43f023c7b8d4831d5246"},
@@ -1414,6 +1417,8 @@ files = [
     {file = "greenlet-3.2.4-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2523e5246274f54fdadbce8494458a2ebdcdbc7b802318466ac5606d3cded1f8"},
     {file = "greenlet-3.2.4-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:1987de92fec508535687fb807a5cea1560f6196285a4cde35c100b8cd632cc52"},
     {file = "greenlet-3.2.4-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:55e9c5affaa6775e2c6b67659f3a71684de4c549b3dd9afca3bc773533d284fa"},
+    {file = "greenlet-3.2.4-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:c9c6de1940a7d828635fbd254d69db79e54619f165ee7ce32fda763a9cb6a58c"},
+    {file = "greenlet-3.2.4-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:03c5136e7be905045160b1b9fdca93dd6727b180feeafda6818e6496434ed8c5"},
     {file = "greenlet-3.2.4-cp311-cp311-win_amd64.whl", hash = "sha256:9c40adce87eaa9ddb593ccb0fa6a07caf34015a29bf8d344811665b573138db9"},
     {file = "greenlet-3.2.4-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:3b67ca49f54cede0186854a008109d6ee71f66bd57bb36abd6d0a0267b540cdd"},
     {file = "greenlet-3.2.4-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:ddf9164e7a5b08e9d22511526865780a576f19ddd00d62f8a665949327fde8bb"},
@@ -1423,6 +1428,8 @@ files = [
     {file = "greenlet-3.2.4-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3b3812d8d0c9579967815af437d96623f45c0f2ae5f04e366de62a12d83a8fb0"},
     {file = "greenlet-3.2.4-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:abbf57b5a870d30c4675928c37278493044d7c14378350b3aa5d484fa65575f0"},
     {file = "greenlet-3.2.4-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:20fb936b4652b6e307b8f347665e2c615540d4b42b3b4c8a321d8286da7e520f"},
+    {file = "greenlet-3.2.4-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:ee7a6ec486883397d70eec05059353b8e83eca9168b9f3f9a361971e77e0bcd0"},
+    {file = "greenlet-3.2.4-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:326d234cbf337c9c3def0676412eb7040a35a768efc92504b947b3e9cfc7543d"},
     {file = "greenlet-3.2.4-cp312-cp312-win_amd64.whl", hash = "sha256:a7d4e128405eea3814a12cc2605e0e6aedb4035bf32697f72deca74de4105e02"},
     {file = "greenlet-3.2.4-cp313-cp313-macosx_11_0_universal2.whl", hash = "sha256:1a921e542453fe531144e91e1feedf12e07351b1cf6c9e8a3325ea600a715a31"},
     {file = "greenlet-3.2.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:cd3c8e693bff0fff6ba55f140bf390fa92c994083f838fece0f63be121334945"},
@@ -1432,6 +1439,8 @@ files = [
     {file = "greenlet-3.2.4-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:23768528f2911bcd7e475210822ffb5254ed10d71f4028387e5a99b4c6699671"},
     {file = "greenlet-3.2.4-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:00fadb3fedccc447f517ee0d3fd8fe49eae949e1cd0f6a611818f4f6fb7dc83b"},
     {file = "greenlet-3.2.4-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:d25c5091190f2dc0eaa3f950252122edbbadbb682aa7b1ef2f8af0f8c0afefae"},
+    {file = "greenlet-3.2.4-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:6e343822feb58ac4d0a1211bd9399de2b3a04963ddeec21530fc426cc121f19b"},
+    {file = "greenlet-3.2.4-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:ca7f6f1f2649b89ce02f6f229d7c19f680a6238af656f61e0115b24857917929"},
     {file = "greenlet-3.2.4-cp313-cp313-win_amd64.whl", hash = "sha256:554b03b6e73aaabec3745364d6239e9e012d64c68ccd0b8430c64ccc14939a8b"},
     {file = "greenlet-3.2.4-cp314-cp314-macosx_11_0_universal2.whl", hash = "sha256:49a30d5fda2507ae77be16479bdb62a660fa51b1eb4928b524975b3bde77b3c0"},
     {file = "greenlet-3.2.4-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:299fd615cd8fc86267b47597123e3f43ad79c9d8a22bebdce535e53550763e2f"},
@@ -1439,6 +1448,8 @@ files = [
     {file = "greenlet-3.2.4-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:b4a1870c51720687af7fa3e7cda6d08d801dae660f75a76f3845b642b4da6ee1"},
     {file = "greenlet-3.2.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:061dc4cf2c34852b052a8620d40f36324554bc192be474b9e9770e8c042fd735"},
     {file = "greenlet-3.2.4-cp314-cp314-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:44358b9bf66c8576a9f57a590d5f5d6e72fa4228b763d0e43fee6d3b06d3a337"},
+    {file = "greenlet-3.2.4-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:2917bdf657f5859fbf3386b12d68ede4cf1f04c90c3a6bc1f013dd68a22e2269"},
+    {file = "greenlet-3.2.4-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:015d48959d4add5d6c9f6c5210ee3803a830dce46356e3bc326d6776bde54681"},
     {file = "greenlet-3.2.4-cp314-cp314-win_amd64.whl", hash = "sha256:e37ab26028f12dbb0ff65f29a8d3d44a765c61e729647bf2ddfbbed621726f01"},
     {file = "greenlet-3.2.4-cp39-cp39-macosx_11_0_universal2.whl", hash = "sha256:b6a7c19cf0d2742d0809a4c05975db036fdff50cd294a93632d6a310bf9ac02c"},
     {file = "greenlet-3.2.4-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:27890167f55d2387576d1f41d9487ef171849ea0359ce1510ca6e06c8bece11d"},
@@ -1448,6 +1459,8 @@ files = [
     {file = "greenlet-3.2.4-cp39-cp39-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c9913f1a30e4526f432991f89ae263459b1c64d1608c0d22a5c79c287b3c70df"},
     {file = "greenlet-3.2.4-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:b90654e092f928f110e0007f572007c9727b5265f7632c2fa7415b4689351594"},
     {file = "greenlet-3.2.4-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:81701fd84f26330f0d5f4944d4e92e61afe6319dcd9775e39396e39d7c3e5f98"},
+    {file = "greenlet-3.2.4-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:28a3c6b7cd72a96f61b0e4b2a36f681025b60ae4779cc73c1535eb5f29560b10"},
+    {file = "greenlet-3.2.4-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:52206cd642670b0b320a1fd1cbfd95bca0e043179c1d8a045f2c6109dfe973be"},
     {file = "greenlet-3.2.4-cp39-cp39-win32.whl", hash = "sha256:65458b409c1ed459ea899e939f0e1cdb14f58dbc803f2f93c5eab5694d32671b"},
     {file = "greenlet-3.2.4-cp39-cp39-win_amd64.whl", hash = "sha256:d2e685ade4dafd447ede19c31277a224a239a0a1a4eca4e6390efedf20260cfb"},
     {file = "greenlet-3.2.4.tar.gz", hash = "sha256:0dca0d95ff849f9a364385f36ab49f50065d76964944638be9691e1832e9f86d"},
@@ -1883,7 +1896,7 @@ description = "IPython: Productive Interactive Computing"
 optional = false
 python-versions = ">=3.11"
 groups = ["main"]
-markers = "python_version <= \"3.13\" and python_version >= \"3.11\""
+markers = "python_version < \"3.14\" and python_version >= \"3.11\""
 files = [
     {file = "ipython-9.6.0-py3-none-any.whl", hash = "sha256:5f77efafc886d2f023442479b8149e7d86547ad0a979e9da9f045d252f648196"},
     {file = "ipython-9.6.0.tar.gz", hash = "sha256:5603d6d5d356378be5043e69441a072b50a5b33b4503428c77b04cb8ce7bc731"},
@@ -1917,7 +1930,7 @@ description = "Defines a variety of Pygments lexers for highlighting IPython cod
 optional = false
 python-versions = ">=3.8"
 groups = ["main"]
-markers = "python_version <= \"3.13\" and python_version >= \"3.11\""
+markers = "python_version < \"3.14\" and python_version >= \"3.11\""
 files = [
     {file = "ipython_pygments_lexers-1.1.1-py3-none-any.whl", hash = "sha256:a9462224a505ade19a605f71f8fa63c2048833ce50abc86768a0d81d876dc81c"},
     {file = "ipython_pygments_lexers-1.1.1.tar.gz", hash = "sha256:09c0138009e56b6854f9535736f4171d855c8c08a563a0dcd8022f78355c7e81"},
@@ -2213,94 +2226,83 @@ adal = ["adal (>=1.0.2)"]
 
 [[package]]
 name = "langchain"
-version = "0.1.20"
+version = "0.2.17"
 description = "Building applications with LLMs through composability"
 optional = false
 python-versions = "<4.0,>=3.8.1"
 groups = ["main"]
 files = [
-    {file = "langchain-0.1.20-py3-none-any.whl", hash = "sha256:09991999fbd6c3421a12db3c7d1f52d55601fc41d9b2a3ef51aab2e0e9c38da9"},
-    {file = "langchain-0.1.20.tar.gz", hash = "sha256:f35c95eed8c8375e02dce95a34f2fd4856a4c98269d6dc34547a23dba5beab7e"},
+    {file = "langchain-0.2.17-py3-none-any.whl", hash = "sha256:a97a33e775f8de074370aecab95db148b879c794695d9e443c95457dce5eb525"},
+    {file = "langchain-0.2.17.tar.gz", hash = "sha256:5a99ce94aae05925851777dba45cbf2c475565d1e91cbe7d82c5e329d514627e"},
 ]
 
 [package.dependencies]
 aiohttp = ">=3.8.3,<4.0.0"
 async-timeout = {version = ">=4.0.0,<5.0.0", markers = "python_version < \"3.11\""}
-dataclasses-json = ">=0.5.7,<0.7"
-langchain-community = ">=0.0.38,<0.1"
-langchain-core = ">=0.1.52,<0.2.0"
-langchain-text-splitters = ">=0.0.1,<0.1"
+langchain-core = ">=0.2.43,<0.3.0"
+langchain-text-splitters = ">=0.2.0,<0.3.0"
 langsmith = ">=0.1.17,<0.2.0"
-numpy = ">=1,<2"
+numpy = [
+    {version = ">=1,<2", markers = "python_version < \"3.12\""},
+    {version = ">=1.26.0,<2.0.0", markers = "python_version >= \"3.12\""},
+]
 pydantic = ">=1,<3"
 PyYAML = ">=5.3"
 requests = ">=2,<3"
 SQLAlchemy = ">=1.4,<3"
-tenacity = ">=8.1.0,<9.0.0"
-
-[package.extras]
-azure = ["azure-ai-formrecognizer (>=3.2.1,<4.0.0)", "azure-ai-textanalytics (>=5.3.0,<6.0.0)", "azure-cognitiveservices-speech (>=1.28.0,<2.0.0)", "azure-core (>=1.26.4,<2.0.0)", "azure-cosmos (>=4.4.0b1,<5.0.0)", "azure-identity (>=1.12.0,<2.0.0)", "azure-search-documents (==11.4.0b8)", "openai (<2)"]
-clarifai = ["clarifai (>=9.1.0)"]
-cli = ["typer (>=0.9.0,<0.10.0)"]
-cohere = ["cohere (>=4,<6)"]
-docarray = ["docarray[hnswlib] (>=0.32.0,<0.33.0)"]
-embeddings = ["sentence-transformers (>=2,<3)"]
-extended-testing = ["aiosqlite (>=0.19.0,<0.20.0)", "aleph-alpha-client (>=2.15.0,<3.0.0)", "anthropic (>=0.3.11,<0.4.0)", "arxiv (>=1.4,<2.0)", "assemblyai (>=0.17.0,<0.18.0)", "atlassian-python-api (>=3.36.0,<4.0.0)", "beautifulsoup4 (>=4,<5)", "bibtexparser (>=1.4.0,<2.0.0)", "cassio (>=0.1.0,<0.2.0)", "chardet (>=5.1.0,<6.0.0)", "cohere (>=4,<6)", "couchbase (>=4.1.9,<5.0.0)", "dashvector (>=1.0.1,<2.0.0)", "databricks-vectorsearch (>=0.21,<0.22)", "datasets (>=2.15.0,<3.0.0)", "dgml-utils (>=0.3.0,<0.4.0)", "esprima (>=4.0.1,<5.0.0)", "faiss-cpu (>=1,<2)", "feedparser (>=6.0.10,<7.0.0)", "fireworks-ai (>=0.9.0,<0.10.0)", "geopandas (>=0.13.1,<0.14.0)", "gitpython (>=3.1.32,<4.0.0)", "google-cloud-documentai (>=2.20.1,<3.0.0)", "gql (>=3.4.1,<4.0.0)", "hologres-vector (>=0.0.6,<0.0.7)", "html2text (>=2020.1.16,<2021.0.0)", "javelin-sdk (>=0.1.8,<0.2.0)", "jinja2 (>=3,<4)", "jq (>=1.4.1,<2.0.0)", "jsonschema (>1)", "langchain-openai (>=0.0.2,<0.1)", "lxml (>=4.9.3,<6.0)", "markdownify (>=0.11.6,<0.12.0)", "motor (>=3.3.1,<4.0.0)", "msal (>=1.25.0,<2.0.0)", "mwparserfromhell (>=0.6.4,<0.7.0)", "mwxml (>=0.3.3,<0.4.0)", "newspaper3k (>=0.2.8,<0.3.0)", "numexpr (>=2.8.6,<3.0.0)", "openai (<2)", "openapi-pydantic (>=0.3.2,<0.4.0)", "pandas (>=2.0.1,<3.0.0)", "pdfminer-six (>=20221105,<20221106)", "pgvector (>=0.1.6,<0.2.0)", "praw (>=7.7.1,<8.0.0)", "psychicapi (>=0.8.0,<0.9.0)", "py-trello (>=0.19.0,<0.20.0)", "pymupdf (>=1.22.3,<2.0.0)", "pypdf (>=3.4.0,<4.0.0)", "pypdfium2 (>=4.10.0,<5.0.0)", "pyspark (>=3.4.0,<4.0.0)", "rank-bm25 (>=0.2.2,<0.3.0)", "rapidfuzz (>=3.1.1,<4.0.0)", "rapidocr-onnxruntime (>=1.3.2,<2.0.0) ; python_full_version >= \"3.8.1\" and python_version < \"3.12\"", "rdflib (==7.0.0)", "requests-toolbelt (>=1.0.0,<2.0.0)", "rspace_client (>=2.5.0,<3.0.0)", "scikit-learn (>=1.2.2,<2.0.0)", "sqlite-vss (>=0.1.2,<0.2.0)", "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\"", "sympy (>=1.12,<2.0)", "telethon (>=1.28.5,<2.0.0)", "timescale-vector (>=0.0.1,<0.0.2)", "tqdm (>=4.48.0)", "upstash-redis (>=0.15.0,<0.16.0)", "xata (>=1.0.0a7,<2.0.0)", "xmltodict (>=0.13.0,<0.14.0)"]
-javascript = ["esprima (>=4.0.1,<5.0.0)"]
-llms = ["clarifai (>=9.1.0)", "cohere (>=4,<6)", "huggingface_hub (>=0,<1)", "manifest-ml (>=0.0.1,<0.0.2)", "nlpcloud (>=1,<2)", "openai (<2)", "openlm (>=0.0.5,<0.0.6)", "torch (>=1,<3)", "transformers (>=4,<5)"]
-openai = ["openai (<2)", "tiktoken (>=0.3.2,<0.6.0) ; python_version >= \"3.9\""]
-qdrant = ["qdrant-client (>=1.3.1,<2.0.0) ; python_full_version >= \"3.8.1\" and python_version < \"3.12\""]
-text-helpers = ["chardet (>=5.1.0,<6.0.0)"]
+tenacity = ">=8.1.0,<8.4.0 || >8.4.0,<9.0.0"
 
 [[package]]
 name = "langchain-community"
-version = "0.0.38"
+version = "0.2.19"
 description = "Community contributed LangChain integrations."
-optional = false
+optional = true
 python-versions = "<4.0,>=3.8.1"
 groups = ["main"]
+markers = "extra == \"ragas\""
 files = [
-    {file = "langchain_community-0.0.38-py3-none-any.whl", hash = "sha256:ecb48660a70a08c90229be46b0cc5f6bc9f38f2833ee44c57dfab9bf3a2c121a"},
-    {file = "langchain_community-0.0.38.tar.gz", hash = "sha256:127fc4b75bc67b62fe827c66c02e715a730fef8fe69bd2023d466bab06b5810d"},
+    {file = "langchain_community-0.2.19-py3-none-any.whl", hash = "sha256:651d761f2d37d63f89de75d65858f6c7f6ea99c455622e9c13ca041622dad0c5"},
+    {file = "langchain_community-0.2.19.tar.gz", hash = "sha256:74f8db6992d03668c3d82e0d896845c413d167dad3b8e349fb2a9a57fd2d1396"},
 ]
 
 [package.dependencies]
 aiohttp = ">=3.8.3,<4.0.0"
 dataclasses-json = ">=0.5.7,<0.7"
-langchain-core = ">=0.1.52,<0.2.0"
-langsmith = ">=0.1.0,<0.2.0"
-numpy = ">=1,<2"
+langchain = ">=0.2.17,<0.3.0"
+langchain-core = ">=0.2.43,<0.3.0"
+langsmith = ">=0.1.112,<0.2.0"
+numpy = [
+    {version = ">=1,<2", markers = "python_version < \"3.12\""},
+    {version = ">=1.26.0,<2.0.0", markers = "python_version >= \"3.12\""},
+]
 PyYAML = ">=5.3"
 requests = ">=2,<3"
 SQLAlchemy = ">=1.4,<3"
-tenacity = ">=8.1.0,<9.0.0"
-
-[package.extras]
-cli = ["typer (>=0.9.0,<0.10.0)"]
-extended-testing = ["aiosqlite (>=0.19.0,<0.20.0)", "aleph-alpha-client (>=2.15.0,<3.0.0)", "anthropic (>=0.3.11,<0.4.0)", "arxiv (>=1.4,<2.0)", "assemblyai (>=0.17.0,<0.18.0)", "atlassian-python-api (>=3.36.0,<4.0.0)", "azure-ai-documentintelligence (>=1.0.0b1,<2.0.0)", "azure-identity (>=1.15.0,<2.0.0)", "azure-search-documents (==11.4.0)", "beautifulsoup4 (>=4,<5)", "bibtexparser (>=1.4.0,<2.0.0)", "cassio (>=0.1.6,<0.2.0)", "chardet (>=5.1.0,<6.0.0)", "cloudpickle (>=2.0.0)", "cohere (>=4,<5)", "databricks-vectorsearch (>=0.21,<0.22)", "datasets (>=2.15.0,<3.0.0)", "dgml-utils (>=0.3.0,<0.4.0)", "elasticsearch (>=8.12.0,<9.0.0)", "esprima (>=4.0.1,<5.0.0)", "faiss-cpu (>=1,<2)", "feedparser (>=6.0.10,<7.0.0)", "fireworks-ai (>=0.9.0,<0.10.0)", "friendli-client (>=1.2.4,<2.0.0)", "geopandas (>=0.13.1,<0.14.0)", "gitpython (>=3.1.32,<4.0.0)", "google-cloud-documentai (>=2.20.1,<3.0.0)", "gql (>=3.4.1,<4.0.0)", "gradientai (>=1.4.0,<2.0.0)", "hdbcli (>=2.19.21,<3.0.0)", "hologres-vector (>=0.0.6,<0.0.7)", "html2text (>=2020.1.16,<2021.0.0)", "httpx (>=0.24.1,<0.25.0)", "httpx-sse (>=0.4.0,<0.5.0)", "javelin-sdk (>=0.1.8,<0.2.0)", "jinja2 (>=3,<4)", "jq (>=1.4.1,<2.0.0)", "jsonschema (>1)", "lxml (>=4.9.3,<6.0)", "markdownify (>=0.11.6,<0.12.0)", "motor (>=3.3.1,<4.0.0)", "msal (>=1.25.0,<2.0.0)", "mwparserfromhell (>=0.6.4,<0.7.0)", "mwxml (>=0.3.3,<0.4.0)", "newspaper3k (>=0.2.8,<0.3.0)", "numexpr (>=2.8.6,<3.0.0)", "nvidia-riva-client (>=2.14.0,<3.0.0)", "oci (>=2.119.1,<3.0.0)", "openai (<2)", "openapi-pydantic (>=0.3.2,<0.4.0)", "oracle-ads (>=2.9.1,<3.0.0)", "oracledb (>=2.2.0,<3.0.0)", "pandas (>=2.0.1,<3.0.0)", "pdfminer-six (>=20221105,<20221106)", "pgvector (>=0.1.6,<0.2.0)", "praw (>=7.7.1,<8.0.0)", "premai (>=0.3.25,<0.4.0)", "psychicapi (>=0.8.0,<0.9.0)", "py-trello (>=0.19.0,<0.20.0)", "pyjwt (>=2.8.0,<3.0.0)", "pymupdf (>=1.22.3,<2.0.0)", "pypdf (>=3.4.0,<4.0.0)", "pypdfium2 (>=4.10.0,<5.0.0)", "pyspark (>=3.4.0,<4.0.0)", "rank-bm25 (>=0.2.2,<0.3.0)", "rapidfuzz (>=3.1.1,<4.0.0)", "rapidocr-onnxruntime (>=1.3.2,<2.0.0) ; python_full_version >= \"3.8.1\" and python_version < \"3.12\"", "rdflib (==7.0.0)", "requests-toolbelt (>=1.0.0,<2.0.0)", "rspace_client (>=2.5.0,<3.0.0)", "scikit-learn (>=1.2.2,<2.0.0)", "sqlite-vss (>=0.1.2,<0.2.0)", "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\"", "sympy (>=1.12,<2.0)", "telethon (>=1.28.5,<2.0.0)", "tidb-vector (>=0.0.3,<1.0.0)", "timescale-vector (>=0.0.1,<0.0.2)", "tqdm (>=4.48.0)", "tree-sitter (>=0.20.2,<0.21.0)", "tree-sitter-languages (>=1.8.0,<2.0.0)", "upstash-redis (>=0.15.0,<0.16.0)", "vdms (>=0.0.20,<0.0.21)", "xata (>=1.0.0a7,<2.0.0)", "xmltodict (>=0.13.0,<0.14.0)"]
+tenacity = ">=8.1.0,<8.4.0 || >8.4.0,<9.0.0"
 
 [[package]]
 name = "langchain-core"
-version = "0.1.53"
+version = "0.2.43"
 description = "Building applications with LLMs through composability"
 optional = false
 python-versions = "<4.0,>=3.8.1"
 groups = ["main"]
 files = [
-    {file = "langchain_core-0.1.53-py3-none-any.whl", hash = "sha256:02a88a21e3bd294441b5b741625fa4b53b1c684fd58ba6e5d9028e53cbe8542f"},
-    {file = "langchain_core-0.1.53.tar.gz", hash = "sha256:df3773a553b5335eb645827b99a61a7018cea4b11dc45efa2613fde156441cec"},
+    {file = "langchain_core-0.2.43-py3-none-any.whl", hash = "sha256:619601235113298ebf8252a349754b7c28d3cf7166c7c922da24944b78a9363a"},
+    {file = "langchain_core-0.2.43.tar.gz", hash = "sha256:42c2ef6adedb911f4254068b6adc9eb4c4075f6c8cb3d83590d3539a815695f5"},
 ]
 
 [package.dependencies]
 jsonpatch = ">=1.33,<2.0"
-langsmith = ">=0.1.0,<0.2.0"
-packaging = ">=23.2,<24.0"
-pydantic = ">=1,<3"
+langsmith = ">=0.1.112,<0.2.0"
+packaging = ">=23.2,<25"
+pydantic = [
+    {version = ">=1,<3", markers = "python_full_version < \"3.12.4\""},
+    {version = ">=2.7.4,<3.0.0", markers = "python_full_version >= \"3.12.4\""},
+]
 PyYAML = ">=5.3"
-tenacity = ">=8.1.0,<9.0.0"
-
-[package.extras]
-extended-testing = ["jinja2 (>=3,<4)"]
+tenacity = ">=8.1.0,<8.4.0 || >8.4.0,<9.0.0"
+typing-extensions = ">=4.7"
 
 [[package]]
 name = "langchain-openai"
@@ -2322,21 +2324,70 @@ tiktoken = ">=0.7,<1"
 
 [[package]]
 name = "langchain-text-splitters"
-version = "0.0.2"
+version = "0.2.4"
 description = "LangChain text splitting utilities"
 optional = false
 python-versions = "<4.0,>=3.8.1"
 groups = ["main"]
 files = [
-    {file = "langchain_text_splitters-0.0.2-py3-none-any.whl", hash = "sha256:13887f32705862c1e1454213cb7834a63aae57c26fcd80346703a1d09c46168d"},
-    {file = "langchain_text_splitters-0.0.2.tar.gz", hash = "sha256:ac8927dc0ba08eba702f6961c9ed7df7cead8de19a9f7101ab2b5ea34201b3c1"},
+    {file = "langchain_text_splitters-0.2.4-py3-none-any.whl", hash = "sha256:2702dee5b7cbdd595ccbe43b8d38d01a34aa8583f4d6a5a68ad2305ae3e7b645"},
+    {file = "langchain_text_splitters-0.2.4.tar.gz", hash = "sha256:f7daa7a3b0aa8309ce248e2e2b6fc8115be01118d336c7f7f7dfacda0e89bf29"},
 ]
 
 [package.dependencies]
-langchain-core = ">=0.1.28,<0.3"
+langchain-core = ">=0.2.38,<0.3.0"
 
-[package.extras]
-extended-testing = ["beautifulsoup4 (>=4.12.3,<5.0.0)", "lxml (>=4.9.3,<6.0)"]
+[[package]]
+name = "langgraph"
+version = "0.2.76"
+description = "Building stateful, multi-actor applications with LLMs"
+optional = true
+python-versions = "<4.0,>=3.9.0"
+groups = ["main"]
+markers = "extra == \"integration-tests\""
+files = [
+    {file = "langgraph-0.2.76-py3-none-any.whl", hash = "sha256:076b8b5d2fc5a9761c46a7618430cfa5c978a8012257c43cbc127b27e0fd7872"},
+    {file = "langgraph-0.2.76.tar.gz", hash = "sha256:688f8dcd9b6797ba78384599e0de944773000c75156ad1e186490e99e89fa5c0"},
+]
+
+[package.dependencies]
+langchain-core = ">=0.2.43,<0.3.0 || >0.3.0,<0.3.1 || >0.3.1,<0.3.2 || >0.3.2,<0.3.3 || >0.3.3,<0.3.4 || >0.3.4,<0.3.5 || >0.3.5,<0.3.6 || >0.3.6,<0.3.7 || >0.3.7,<0.3.8 || >0.3.8,<0.3.9 || >0.3.9,<0.3.10 || >0.3.10,<0.3.11 || >0.3.11,<0.3.12 || >0.3.12,<0.3.13 || >0.3.13,<0.3.14 || >0.3.14,<0.3.15 || >0.3.15,<0.3.16 || >0.3.16,<0.3.17 || >0.3.17,<0.3.18 || >0.3.18,<0.3.19 || >0.3.19,<0.3.20 || >0.3.20,<0.3.21 || >0.3.21,<0.3.22 || >0.3.22,<0.4.0"
+langgraph-checkpoint = ">=2.0.10,<3.0.0"
+langgraph-sdk = ">=0.1.42,<0.2.0"
+
+[[package]]
+name = "langgraph-checkpoint"
+version = "2.1.2"
+description = "Library with base interfaces for LangGraph checkpoint savers."
+optional = true
+python-versions = ">=3.9"
+groups = ["main"]
+markers = "extra == \"integration-tests\""
+files = [
+    {file = "langgraph_checkpoint-2.1.2-py3-none-any.whl", hash = "sha256:911ebffb069fd01775d4b5184c04aaafc2962fcdf50cf49d524cd4367c4d0c60"},
+    {file = "langgraph_checkpoint-2.1.2.tar.gz", hash = "sha256:112e9d067a6eff8937caf198421b1ffba8d9207193f14ac6f89930c1260c06f9"},
+]
+
+[package.dependencies]
+langchain-core = ">=0.2.38"
+ormsgpack = ">=1.10.0"
+
+[[package]]
+name = "langgraph-sdk"
+version = "0.1.74"
+description = "SDK for interacting with LangGraph API"
+optional = true
+python-versions = ">=3.9"
+groups = ["main"]
+markers = "extra == \"integration-tests\""
+files = [
+    {file = "langgraph_sdk-0.1.74-py3-none-any.whl", hash = "sha256:3a265c3757fe0048adad4391d10486db63ef7aa5a2cbd22da22d4503554cb890"},
+    {file = "langgraph_sdk-0.1.74.tar.gz", hash = "sha256:7450e0db5b226cc2e5328ca22c5968725873630ef47c4206a30707cb25dc3ad6"},
+]
+
+[package.dependencies]
+httpx = ">=0.25.2"
+orjson = ">=3.10.1"
 
 [[package]]
 name = "langsmith"
@@ -2524,9 +2575,10 @@ markers = {main = "python_version < \"3.14\""}
 name = "marshmallow"
 version = "3.26.1"
 description = "A lightweight library for converting complex datatypes to and from native Python datatypes."
-optional = false
+optional = true
 python-versions = ">=3.9"
 groups = ["main"]
+markers = "extra == \"ragas\""
 files = [
     {file = "marshmallow-3.26.1-py3-none-any.whl", hash = "sha256:3350409f20a70a7e4e11a27661187b77cdcaeb20abca41c1454fe33636bea09c"},
     {file = "marshmallow-3.26.1.tar.gz", hash = "sha256:e6d8affb6cb61d39d26402096dc0aee12d5a26d490a121f118d2e81dc0719dc6"},
@@ -2880,9 +2932,10 @@ dill = ">=0.3.8"
 name = "mypy-extensions"
 version = "1.1.0"
 description = "Type system extensions for programs checked with the mypy type checker."
-optional = false
+optional = true
 python-versions = ">=3.8"
 groups = ["main"]
+markers = "extra == \"ragas\""
 files = [
     {file = "mypy_extensions-1.1.0-py3-none-any.whl", hash = "sha256:1be4cccdb0f2482337c4743e60421de3a356cd97508abadd57d47403e94f5505"},
     {file = "mypy_extensions-1.1.0.tar.gz", hash = "sha256:52e68efc3284861e772bbcd66823fde5ae21fd2fdb51c62a211403730b916558"},
@@ -2929,7 +2982,7 @@ description = "Python package for creating and manipulating graphs and networks"
 optional = false
 python-versions = ">=3.11"
 groups = ["main"]
-markers = "python_version <= \"3.13\" and python_version >= \"3.11\""
+markers = "python_version < \"3.14\" and python_version >= \"3.11\""
 files = [
     {file = "networkx-3.5-py3-none-any.whl", hash = "sha256:0030d386a9a06dee3565298b4a734b68589749a544acbb6c412dc9e2489ec6ec"},
     {file = "networkx-3.5.tar.gz", hash = "sha256:d4c6f9cf81f52d69230866796b82afbccdec3db7ae4fbd1b65ea750feed50037"},
@@ -3241,7 +3294,7 @@ description = "Fast, correct Python JSON library supporting dataclasses, datetim
 optional = false
 python-versions = ">=3.9"
 groups = ["main"]
-markers = "python_version < \"3.14\" or platform_python_implementation != \"PyPy\""
+markers = "python_version < \"3.14\" or platform_python_implementation != \"PyPy\" or extra == \"integration-tests\""
 files = [
     {file = "orjson-3.11.3-cp310-cp310-macosx_10_15_x86_64.macosx_11_0_arm64.macosx_10_15_universal2.whl", hash = "sha256:29cb1f1b008d936803e2da3d7cba726fc47232c45df531b29edf0b232dd737e7"},
     {file = "orjson-3.11.3-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:97dceed87ed9139884a55db8722428e27bd8452817fbf1869c58b49fecab1120"},
@@ -3328,6 +3381,65 @@ files = [
     {file = "orjson-3.11.3.tar.gz", hash = "sha256:1c0603b1d2ffcd43a411d64797a19556ef76958aef1c182f22dc30860152a98a"},
 ]
 
+[[package]]
+name = "ormsgpack"
+version = "1.12.0"
+description = ""
+optional = true
+python-versions = ">=3.10"
+groups = ["main"]
+markers = "extra == \"integration-tests\""
+files = [
+    {file = "ormsgpack-1.12.0-cp310-cp310-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:e08904c232358b94a682ccfbb680bc47d3fd5c424bb7dccb65974dd20c95e8e1"},
+    {file = "ormsgpack-1.12.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b9ed7a4b0037d69c8ba7e670e03ee65ae8d5c5114a409e73c5770d7fb5e4b895"},
+    {file = "ormsgpack-1.12.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:db2928525b684f3f2af0367aef7ae8d20cde37fc5349c700017129d493a755aa"},
+    {file = "ormsgpack-1.12.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:45f911d9c5b23d11e49ff03fc8f9566745a2b1a7d9033733a1c0a2fa9301cd60"},
+    {file = "ormsgpack-1.12.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:98c54ae6fd682b2aceb264505af9b2255f3df9d84e6e4369bc44d2110f1f311d"},
+    {file = "ormsgpack-1.12.0-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:857ab987c3502de08258cc4baf0e87267cb2c80931601084e13df3c355b1ab9d"},
+    {file = "ormsgpack-1.12.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:27579d45dc502ee736238e1024559cb0a01aa72a3b68827448b8edf6a2dcdc9c"},
+    {file = "ormsgpack-1.12.0-cp310-cp310-win_amd64.whl", hash = "sha256:c78379d054760875540cf2e81f28da1bb78d09fda3eabdbeb6c53b3e297158cb"},
+    {file = "ormsgpack-1.12.0-cp311-cp311-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:c40d86d77391b18dd34de5295e3de2b8ad818bcab9c9def4121c8ec5c9714ae4"},
+    {file = "ormsgpack-1.12.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:777b7fab364dc0f200bb382a98a385c8222ffa6a2333d627d763797326202c86"},
+    {file = "ormsgpack-1.12.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:b5b5089ad9dd5b3d3013b245a55e4abaea2f8ad70f4a78e1b002127b02340004"},
+    {file = "ormsgpack-1.12.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:deaf0c87cace7bc08fbf68c5cc66605b593df6427e9f4de235b2da358787e008"},
+    {file = "ormsgpack-1.12.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:f62d476fe28bc5675d9aff30341bfa9f41d7de332c5b63fbbe9aaf6bb7ec74d4"},
+    {file = "ormsgpack-1.12.0-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:ded7810095b887e28434f32f5a345d354e88cf851bab3c5435aeb86a718618d2"},
+    {file = "ormsgpack-1.12.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:f72a1dea0c4ae7c4101dcfbe8133f274a9d769d0b87fe5188db4fab07ffabaee"},
+    {file = "ormsgpack-1.12.0-cp311-cp311-win_amd64.whl", hash = "sha256:8f479bfef847255d7d0b12c7a198f6a21490155da2da3062e082ba370893d4a1"},
+    {file = "ormsgpack-1.12.0-cp311-cp311-win_arm64.whl", hash = "sha256:3583ca410e4502144b2594170542e4bbef7b15643fd1208703ae820f11029036"},
+    {file = "ormsgpack-1.12.0-cp312-cp312-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:e0c1e08b64d99076fee155276097489b82cc56e8d5951c03c721a65a32f44494"},
+    {file = "ormsgpack-1.12.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3fd43bcb299131690b8e0677af172020b2ada8e625169034b42ac0c13adf84aa"},
+    {file = "ormsgpack-1.12.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5f0149d595341e22ead340bf281b2995c4cc7dc8d522a6b5f575fe17aa407604"},
+    {file = "ormsgpack-1.12.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f19a1b27d169deb553c80fd10b589fc2be1fc14cee779fae79fcaf40db04de2b"},
+    {file = "ormsgpack-1.12.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:6f28896942d655064940dfe06118b7ce1e3468d051483148bf02c99ec157483a"},
+    {file = "ormsgpack-1.12.0-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:9396efcfa48b4abbc06e44c5dbc3c4574a8381a80cb4cd01eea15d28b38c554e"},
+    {file = "ormsgpack-1.12.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:96586ed537a5fb386a162c4f9f7d8e6f76e07b38a990d50c73f11131e00ff040"},
+    {file = "ormsgpack-1.12.0-cp312-cp312-win_amd64.whl", hash = "sha256:e70387112fb3870e4844de090014212cdcf1342f5022047aecca01ec7de05d7a"},
+    {file = "ormsgpack-1.12.0-cp312-cp312-win_arm64.whl", hash = "sha256:d71290a23de5d4829610c42665d816c661ecad8979883f3f06b2e3ab9639962e"},
+    {file = "ormsgpack-1.12.0-cp313-cp313-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:766f2f3b512d85cd375b26a8b1329b99843560b50b93d3880718e634ad4a5de5"},
+    {file = "ormsgpack-1.12.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:84b285b1f3f185aad7da45641b873b30acfd13084cf829cf668c4c6480a81583"},
+    {file = "ormsgpack-1.12.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e23604fc79fe110292cb365f4c8232e64e63a34f470538be320feae3921f271b"},
+    {file = "ormsgpack-1.12.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:dc32b156c113a0fae2975051417d8d9a7a5247c34b2d7239410c46b75ce9348a"},
+    {file = "ormsgpack-1.12.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:94ac500dd10c20fa8b8a23bc55606250bfe711bf9716828d9f3d44dfd1f25668"},
+    {file = "ormsgpack-1.12.0-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:c5201ff7ec24f721f813a182885a17064cffdbe46b2412685a52e6374a872c8f"},
+    {file = "ormsgpack-1.12.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:a9740bb3839c9368aacae1cbcfc474ee6976458f41cc135372b7255d5206c953"},
+    {file = "ormsgpack-1.12.0-cp313-cp313-win_amd64.whl", hash = "sha256:8ed37f29772432048b58174e920a1d4c4cde0404a5d448d3d8bbcc95d86a6918"},
+    {file = "ormsgpack-1.12.0-cp313-cp313-win_arm64.whl", hash = "sha256:b03994bbec5d6d42e03d6604e327863f885bde67aa61e06107ce1fa5bdd3e71d"},
+    {file = "ormsgpack-1.12.0-cp314-cp314-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:0f3981ba3cba80656012090337e548e597799e14b41e3d0b595ab5ab05a23d7f"},
+    {file = "ormsgpack-1.12.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:901f6f55184d6776dbd5183cbce14caf05bf7f467eef52faf9b094686980bf71"},
+    {file = "ormsgpack-1.12.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e13b15412571422b711b40f45e3fe6d993ea3314b5e97d1a853fe99226c5effc"},
+    {file = "ormsgpack-1.12.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:91fa8a452553a62e5fb3fbab471e7faf7b3bec3c87a2f355ebf3d7aab290fe4f"},
+    {file = "ormsgpack-1.12.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:74ec101f69624695eec4ce7c953192d97748254abe78fb01b591f06d529e1952"},
+    {file = "ormsgpack-1.12.0-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:9bbf7896580848326c1f9bd7531f264e561f98db7e08e15aa75963d83832c717"},
+    {file = "ormsgpack-1.12.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:7567917da613b8f8d591c1674e411fd3404bea41ef2b9a0e0a1e049c0f9406d7"},
+    {file = "ormsgpack-1.12.0-cp314-cp314-win_amd64.whl", hash = "sha256:4e418256c5d8622b8bc92861936f7c6a0131355e7bcad88a42102ae8227f8a1c"},
+    {file = "ormsgpack-1.12.0-cp314-cp314-win_arm64.whl", hash = "sha256:433ace29aa02713554f714c62a4e4dcad0c9e32674ba4f66742c91a4c3b1b969"},
+    {file = "ormsgpack-1.12.0-cp314-cp314t-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl", hash = "sha256:e57164be4ca34b64e210ec515059193280ac84df4d6f31a6fcbfb2fc8436de55"},
+    {file = "ormsgpack-1.12.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:904f96289deaa92fc6440b122edc27c5bdc28234edd63717f6d853d88c823a83"},
+    {file = "ormsgpack-1.12.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4b291d086e524a1062d57d1b7b5a8bcaaf29caebf0212fec12fd86240bd33633"},
+    {file = "ormsgpack-1.12.0.tar.gz", hash = "sha256:94be818fdbb0285945839b88763b269987787cb2f7ef280cad5d6ec815b7e608"},
+]
+
 [[package]]
 name = "overrides"
 version = "7.7.0"
@@ -3505,7 +3617,7 @@ description = "Pexpect allows easy control of interactive console applications."
 optional = false
 python-versions = "*"
 groups = ["main"]
-markers = "python_version < \"3.14\" and sys_platform != \"win32\" and sys_platform != \"emscripten\""
+markers = "sys_platform != \"win32\" and sys_platform != \"emscripten\" and python_version < \"3.14\""
 files = [
     {file = "pexpect-4.9.0-py2.py3-none-any.whl", hash = "sha256:7236d1e080e4936be2dc3e326cec0af72acf9212a7e1d060210e70a47e253523"},
     {file = "pexpect-4.9.0.tar.gz", hash = "sha256:ee7d41123f3c9911050ea2c2dac107568dc43b2d3b0c7557a33212c398ead30f"},
@@ -3853,7 +3965,7 @@ description = "Run a subprocess in a pseudo terminal"
 optional = false
 python-versions = "*"
 groups = ["main"]
-markers = "python_version < \"3.14\" and sys_platform != \"win32\" and sys_platform != \"emscripten\""
+markers = "sys_platform != \"win32\" and sys_platform != \"emscripten\" and python_version < \"3.14\""
 files = [
     {file = "ptyprocess-0.7.0-py2.py3-none-any.whl", hash = "sha256:4b41f3967fce3af57cc7e94b888626c18bf37a083e3651ca8feeb66d492fef35"},
     {file = "ptyprocess-0.7.0.tar.gz", hash = "sha256:5c5d0a3b48ceee0b48485e0c26037c0acd7d29765ca3fbb5cb3831d347423220"},
@@ -4576,7 +4688,7 @@ description = "Python for Window Extensions"
 optional = false
 python-versions = "*"
 groups = ["main"]
-markers = "python_version < \"3.14\" and platform_system == \"Windows\""
+markers = "platform_system == \"Windows\" and python_version < \"3.14\""
 files = [
     {file = "pywin32-311-cp310-cp310-win32.whl", hash = "sha256:d03ff496d2a0cd4a5893504789d4a15399133fe82517455e78bad62efbb7f0a3"},
     {file = "pywin32-311-cp310-cp310-win_amd64.whl", hash = "sha256:797c2772017851984b97180b0bebe4b620bb86328e8a884bb626156295a63b3b"},
@@ -4608,6 +4720,13 @@ optional = false
 python-versions = ">=3.8"
 groups = ["main"]
 files = [
+    {file = "PyYAML-6.0.3-cp38-cp38-macosx_10_13_x86_64.whl", hash = "sha256:c2514fceb77bc5e7a2f7adfaa1feb2fb311607c9cb518dbc378688ec73d8292f"},
+    {file = "PyYAML-6.0.3-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9c57bb8c96f6d1808c030b1687b9b5fb476abaa47f0db9c0101f5e9f394e97f4"},
+    {file = "PyYAML-6.0.3-cp38-cp38-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:efd7b85f94a6f21e4932043973a7ba2613b059c4a000551892ac9f1d11f5baf3"},
+    {file = "PyYAML-6.0.3-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:22ba7cfcad58ef3ecddc7ed1db3409af68d023b7f940da23c6c2a1890976eda6"},
+    {file = "PyYAML-6.0.3-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:6344df0d5755a2c9a276d4473ae6b90647e216ab4757f8426893b5dd2ac3f369"},
+    {file = "PyYAML-6.0.3-cp38-cp38-win32.whl", hash = "sha256:3ff07ec89bae51176c0549bc4c63aa6202991da2d9a6129d7aef7f1407d3f295"},
+    {file = "PyYAML-6.0.3-cp38-cp38-win_amd64.whl", hash = "sha256:5cf4e27da7e3fbed4d6c3d8e797387aaad68102272f8f9752883bc32d61cb87b"},
     {file = "pyyaml-6.0.3-cp310-cp310-macosx_10_13_x86_64.whl", hash = "sha256:214ed4befebe12df36bcc8bc2b64b396ca31be9304b8f59e25c11cf94a4c033b"},
     {file = "pyyaml-6.0.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:02ea2dfa234451bbb8772601d7b8e426c2bfa197136796224e50e35a78777956"},
     {file = "pyyaml-6.0.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b30236e45cf30d2b8e7b3e85881719e98507abed1011bf463a8fa23e9c3e98a8"},
@@ -5805,9 +5924,10 @@ markers = {dev = "python_version == \"3.10\""}
 name = "typing-inspect"
 version = "0.9.0"
 description = "Runtime inspection utilities for typing module."
-optional = false
+optional = true
 python-versions = "*"
 groups = ["main"]
+markers = "extra == \"ragas\""
 files = [
     {file = "typing_inspect-0.9.0-py3-none-any.whl", hash = "sha256:9ee6fc59062311ef8547596ab6b955e1b8aa46242d854bfc78f4f6b0eff35f9f"},
     {file = "typing_inspect-0.9.0.tar.gz", hash = "sha256:b23fc42ff6f6ef6954e4852c1fb512cdd18dbea03134f91f856a95ccc9461f78"},
@@ -5928,7 +6048,7 @@ description = "Fast implementation of asyncio event loop on top of libuv"
 optional = false
 python-versions = ">=3.8.0"
 groups = ["main"]
-markers = "sys_platform != \"win32\" and sys_platform != \"cygwin\" and platform_python_implementation != \"PyPy\" and python_version < \"3.14\""
+markers = "platform_python_implementation != \"PyPy\" and sys_platform != \"win32\" and sys_platform != \"cygwin\" and python_version < \"3.14\""
 files = [
     {file = "uvloop-0.21.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:ec7e6b09a6fdded42403182ab6b832b71f4edaf7f37a9a0e371a01db5f0cb45f"},
     {file = "uvloop-0.21.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:196274f2adb9689a289ad7d65700d37df0c0930fd8e4e743fa4834e850d7719d"},
@@ -6479,9 +6599,10 @@ test = ["big-O", "jaraco.functools", "jaraco.itertools", "jaraco.test", "more_it
 type = ["pytest-mypy"]
 
 [extras]
+integration-tests = ["langgraph"]
 ragas = ["ragas"]
 
 [metadata]
 lock-version = "2.1"
 python-versions = "^3.10"
-content-hash = "bf0bdc32abb1f3a1f03f3737e0ad7a3a5dc3155f87a9a07beb20bf0bd841a1c4"
+content-hash = "a501d52b324b24d6ebc3204a6da8e172b0af05f3144c47538dce0b435b07c8c2"
diff --git a/pyproject.toml b/pyproject.toml
index 25c2501..b996220 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -24,7 +24,7 @@ classifiers = [
 python = "^3.10"
 pyyaml = "^6.0"
 crewai = { version = "^0.201.1", python = "<3.14" }
-langchain = ">=0.0.353,<0.2.0"  # security: stay on patched 0.0.x line compatible with ecosystem
+langchain = ">=0.0.353,<0.4.0"  # security: stay on patched line compatible with ecosystem
 opentelemetry-api = "^1.25.0"
 opentelemetry-sdk = "^1.25.0"
 opentelemetry-exporter-otlp = "^1.25.0"
@@ -34,9 +34,11 @@ httpx = "^0.27.0"
 numpy = "^1.24.0"
 scipy = "^1.11.0"
 ragas = { version = ">=0.1.9", optional = true }
+langgraph = { version = "^0.2.0", optional = true }
 
 [tool.poetry.extras]
 ragas = ["ragas"]
+integration-tests = ["langgraph"]
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.2.0"
@@ -54,3 +56,18 @@ agentunit = "agentunit.cli:entrypoint"
 requires = ["poetry-core>=1.8.2"]
 build-backend = "poetry.core.masonry.api"
 
+[tool.pytest.ini_options]
+markers = [
+    "integration: marks tests as integration tests (deselect with '-m \"not integration\"')",
+    "langgraph: marks tests as requiring LangGraph (skipped if not installed)",
+]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "-ra",
+]
+
diff --git a/tests/__init__.py b/tests/__init__.py
new file mode 100644
index 0000000..d4839a6
--- /dev/null
+++ b/tests/__init__.py
@@ -0,0 +1 @@
+# Tests package
diff --git a/tests/integration/IMPLEMENTATION_SUMMARY.md b/tests/integration/IMPLEMENTATION_SUMMARY.md
new file mode 100644
index 0000000..802d40b
--- /dev/null
+++ b/tests/integration/IMPLEMENTATION_SUMMARY.md
@@ -0,0 +1,131 @@
+# LangGraph Integration Tests - Implementation Summary
+
+This document summarizes the implementation of LangGraph integration tests for AgentUnit (Issue #24).
+
+## ✅ Completed Tasks
+
+### 1. Created Integration Test Structure
+- ✅ Created `tests/integration/` directory
+- ✅ Added `__init__.py` and `conftest.py` for proper test configuration
+- ✅ Configured pytest markers for integration and LangGraph tests
+
+### 2. Simple LangGraph Agent Implementation
+- ✅ Created `simple_langgraph_agent.py` with a working LangGraph agent
+- ✅ Implemented fallback behavior when LangGraph is not installed
+- ✅ Agent handles multiple query types (quantum, python, weather, general)
+- ✅ Compatible with AgentUnit's payload format
+
+### 3. Comprehensive Integration Tests
+- ✅ Created `test_langgraph_integration.py` with full test suite
+- ✅ Tests scenario creation from callable agents and Python files
+- ✅ Tests full evaluation cycle with multiple test cases
+- ✅ Tests metrics integration (when available)
+- ✅ Tests error handling and retry functionality
+- ✅ Tests multiple scenarios running together
+
+### 4. Pytest Configuration
+- ✅ Added pytest markers to `pyproject.toml`
+- ✅ Configured automatic test marking for integration tests
+- ✅ Tests are properly skipped when LangGraph is not installed
+
+### 5. Documentation
+- ✅ Created comprehensive `README.md` for integration tests
+- ✅ Documented prerequisites and running instructions
+- ✅ Added CI configuration example
+- ✅ Updated main project README with integration test information
+
+## ✅ Acceptance Criteria Met
+
+### Integration tests pass with LangGraph installed
+- Tests are designed to pass when LangGraph is available
+- Comprehensive test coverage of AgentUnit + LangGraph integration
+
+### Tests are skipped gracefully without LangGraph
+- Uses `pytest.importorskip()` to skip tests when LangGraph is not available
+- Provides clear skip messages
+- Fallback mock responses work without LangGraph
+
+### CI optionally runs integration tests
+- Provided example CI configuration in `ci-example.yml`
+- Shows how to run integration tests conditionally
+- Demonstrates selective test execution with pytest markers
+
+## 📁 Files Created
+
+```
+tests/integration/
+├── __init__.py                     # Package initialization
+├── conftest.py                     # Test configuration and markers
+├── simple_langgraph_agent.py       # Simple LangGraph agent for testing
+├── test_langgraph_integration.py   # Main integration tests
+├── test_integration_basic.py       # Basic structure tests
+├── README.md                       # Documentation
+├── ci-example.yml                  # CI configuration example
+└── IMPLEMENTATION_SUMMARY.md       # This file
+```
+
+## 🧪 Test Coverage
+
+The integration tests cover:
+
+1. **Scenario Creation**
+   - From callable functions
+   - From Python files
+   - With custom configurations
+
+2. **Full Evaluation Cycle**
+   - Multiple test cases
+   - Success and failure scenarios
+   - Metrics calculation
+   - Trace logging
+
+3. **Error Handling**
+   - Agent failures
+   - Retry logic
+   - Graceful degradation
+
+4. **Framework Integration**
+   - LangGraph adapter registration
+   - Multiple scenario execution
+   - Scenario cloning and modification
+
+## 🚀 Usage Examples
+
+### Run all integration tests:
+```bash
+pytest tests/integration/
+```
+
+### Run only LangGraph tests:
+```bash
+pytest tests/integration/ -m langgraph
+```
+
+### Skip integration tests:
+```bash
+pytest -m "not integration"
+```
+
+### Install LangGraph for testing:
+```bash
+# Install optional integration test dependencies
+poetry install --extras integration-tests
+```
+
+## 🔧 Technical Implementation Details
+
+- **Graceful Dependency Handling**: Uses `pytest.importorskip()` and try/except imports
+- **Mock Fallbacks**: Provides mock responses when dependencies are unavailable
+- **Pytest Markers**: Proper test categorization and selective execution
+- **AgentUnit Integration**: Full compatibility with AgentUnit's Scenario and Runner APIs
+- **CI Ready**: Designed for optional execution in continuous integration
+
+## 🎯 Next Steps
+
+The integration test framework is now ready for:
+1. Adding more framework integrations (CrewAI, AutoGen, etc.)
+2. Expanding test coverage with more complex scenarios
+3. Integration with CI/CD pipelines
+4. Performance and load testing scenarios
+
+This implementation fully addresses Issue #24 and provides a solid foundation for future integration testing needs.
\ No newline at end of file
diff --git a/tests/integration/README.md b/tests/integration/README.md
new file mode 100644
index 0000000..5c2defd
--- /dev/null
+++ b/tests/integration/README.md
@@ -0,0 +1,97 @@
+# Integration Tests
+
+This directory contains integration tests that verify AgentUnit works with real framework implementations.
+
+## LangGraph Integration Tests
+
+The LangGraph integration tests verify that AgentUnit can properly evaluate LangGraph agents through a complete evaluation cycle.
+
+### Prerequisites
+
+To run LangGraph integration tests, you need to install LangGraph:
+
+```bash
+# Install optional integration test dependencies
+poetry install --extras integration-tests
+```
+
+Or install LangGraph manually:
+
+```bash
+poetry add langgraph --group dev
+```
+
+### Running Integration Tests
+
+#### Run all integration tests:
+```bash
+pytest tests/integration/
+```
+
+#### Run only LangGraph tests:
+```bash
+pytest tests/integration/ -m langgraph
+```
+
+#### Skip integration tests (run only unit tests):
+```bash
+pytest -m "not integration"
+```
+
+#### Run with verbose output:
+```bash
+pytest tests/integration/ -v
+```
+
+### Test Structure
+
+- `simple_langgraph_agent.py` - Contains a simple LangGraph agent implementation for testing
+- `test_langgraph_integration.py` - Integration tests for LangGraph adapter
+- `conftest.py` - Test configuration and markers
+
+### What the Tests Cover
+
+1. **Scenario Creation**: Tests creating scenarios from callable agents and Python files
+2. **Full Evaluation Cycle**: Tests running complete evaluation cycles with multiple test cases
+3. **Metrics Integration**: Tests that metrics can be calculated (when available)
+4. **Error Handling**: Tests graceful handling of agent failures
+5. **Retry Logic**: Tests scenario retry functionality
+6. **Multiple Scenarios**: Tests running multiple scenarios together
+
+### CI Integration
+
+The integration tests are designed to be optionally run in CI:
+
+- Tests are automatically skipped if LangGraph is not installed
+- Use pytest markers to selectively run or skip integration tests
+- All tests are marked with `@pytest.mark.integration` and `@pytest.mark.langgraph`
+
+### Adding New Integration Tests
+
+When adding integration tests for other frameworks:
+
+1. Create a simple agent implementation in the framework
+2. Create test cases that cover the full evaluation cycle
+3. Use appropriate pytest markers (e.g., `@pytest.mark.crewai`)
+4. Ensure tests are skipped gracefully when dependencies are not available
+5. Document the prerequisites and running instructions
+
+### Example Usage
+
+```python
+import pytest
+from agentunit import Scenario, run_suite
+from tests.integration.simple_langgraph_agent import invoke_agent
+
+@pytest.mark.langgraph
+@pytest.mark.integration
+def test_my_langgraph_scenario():
+    scenario = Scenario.load_langgraph(
+        path=invoke_agent,
+        dataset=my_dataset,
+        name="my-test"
+    )
+    
+    result = run_suite([scenario])
+    assert len(result.scenarios) == 1
+```
\ No newline at end of file
diff --git a/tests/integration/__init__.py b/tests/integration/__init__.py
new file mode 100644
index 0000000..c4e48cc
--- /dev/null
+++ b/tests/integration/__init__.py
@@ -0,0 +1 @@
+"""Integration tests for AgentUnit with real frameworks."""
diff --git a/tests/integration/ci-example.yml b/tests/integration/ci-example.yml
new file mode 100644
index 0000000..37ca2f5
--- /dev/null
+++ b/tests/integration/ci-example.yml
@@ -0,0 +1,59 @@
+# Example CI configuration for running integration tests
+# This shows how to optionally run integration tests in CI
+
+name: Tests
+
+on: [push, pull_request]
+
+jobs:
+  unit-tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install poetry
+          poetry install
+      
+      - name: Run unit tests (excluding integration)
+        run: |
+          poetry run pytest -m "not integration" --cov=agentunit --cov-report=xml
+      
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+
+  integration-tests:
+    runs-on: ubuntu-latest
+    # Only run integration tests on main branch or when explicitly requested
+    if: github.ref == 'refs/heads/main' || contains(github.event.pull_request.labels.*.name, 'run-integration-tests')
+    
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      
+      - name: Install dependencies including integration test deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install poetry
+          poetry install --extras integration-tests
+      
+      - name: Run integration tests
+        run: |
+          poetry run pytest tests/integration/ -v
+      
+      - name: Run LangGraph specific tests
+        run: |
+          poetry run pytest tests/integration/ -m langgraph -v
\ No newline at end of file
diff --git a/tests/integration/conftest.py b/tests/integration/conftest.py
new file mode 100644
index 0000000..884ce3f
--- /dev/null
+++ b/tests/integration/conftest.py
@@ -0,0 +1,23 @@
+"""Configuration for integration tests."""
+
+from __future__ import annotations
+
+import pytest
+
+
+def pytest_configure(config):
+    """Configure pytest markers for integration tests."""
+    config.addinivalue_line(
+        "markers",
+        "integration: marks tests as integration tests (deselect with '-m \"not integration\"')",
+    )
+    config.addinivalue_line(
+        "markers", "langgraph: marks tests as requiring LangGraph (skipped if not installed)"
+    )
+
+
+def pytest_collection_modifyitems(config, items):
+    """Automatically mark integration tests."""
+    for item in items:
+        if "integration" in str(item.fspath):
+            item.add_marker(pytest.mark.integration)
diff --git a/tests/integration/simple_langgraph_agent.py b/tests/integration/simple_langgraph_agent.py
new file mode 100644
index 0000000..326a874
--- /dev/null
+++ b/tests/integration/simple_langgraph_agent.py
@@ -0,0 +1,136 @@
+"""Simple LangGraph agent for integration testing."""
+
+from __future__ import annotations
+
+from typing import Any, TypedDict
+
+
+try:
+    from langchain_core.messages import AIMessage, BaseMessage, HumanMessage
+    from langgraph.graph import END, StateGraph
+    from langgraph.graph.message import add_messages
+
+    LANGGRAPH_AVAILABLE = True
+except ImportError:
+    LANGGRAPH_AVAILABLE = False
+
+    # Fallback types for when LangGraph is not available
+    class StateGraph:
+        pass
+
+    class BaseMessage:
+        pass
+
+    class HumanMessage:
+        pass
+
+    class AIMessage:
+        pass
+
+    END = "END"
+
+    def add_messages(a, b):
+        return a + b
+
+
+class AgentState(TypedDict):
+    """State for the simple agent."""
+
+    messages: list[BaseMessage]
+    query: str
+    context: list[str]
+    tools: list[str]
+    metadata: dict[str, Any]
+
+
+def create_simple_agent():
+    """Create a simple LangGraph agent for testing."""
+    if not LANGGRAPH_AVAILABLE:
+        raise ImportError("LangGraph is not available")
+
+    def process_query(state: AgentState) -> AgentState:
+        """Process the user query and generate a response."""
+        query = state.get("query", "")
+        context = state.get("context", [])
+
+        # Simple response generation based on query
+        if "quantum" in query.lower():
+            response = "Quantum tunneling is a quantum mechanical phenomenon where particles can pass through energy barriers."
+        elif "python" in query.lower():
+            response = "Python is a high-level programming language known for its simplicity and readability."
+        elif "weather" in query.lower():
+            response = "I would need access to weather APIs to provide current weather information."
+        else:
+            response = f"I understand you're asking about: {query}"
+
+        # Add context if available
+        if context:
+            response += f" Based on the context: {', '.join(context)}"
+
+        # Create response message
+        ai_message = AIMessage(content=response)
+
+        return {**state, "messages": [*state.get("messages", []), ai_message]}
+
+    def should_continue(state: AgentState) -> str:
+        """Determine if the agent should continue processing."""
+        return END
+
+    # Create the graph
+    workflow = StateGraph(AgentState)
+
+    # Add nodes
+    workflow.add_node("process", process_query)
+
+    # Set entry point
+    workflow.set_entry_point("process")
+
+    # Add edges
+    workflow.add_conditional_edges("process", should_continue, {END: END})
+
+    # Compile the graph
+    return workflow.compile()
+
+
+def invoke_agent(payload: dict[str, Any]) -> dict[str, Any]:
+    """Invoke the agent with a payload compatible with AgentUnit."""
+    if not LANGGRAPH_AVAILABLE:
+        # Return a mock response when LangGraph is not available
+        return {
+            "result": f"Mock response for: {payload.get('query', 'unknown query')}",
+            "events": [],
+        }
+
+    agent = create_simple_agent()
+
+    # Convert payload to agent state
+    initial_state = {
+        "messages": [HumanMessage(content=payload.get("query", ""))],
+        "query": payload.get("query", ""),
+        "context": payload.get("context", []),
+        "tools": payload.get("tools", []),
+        "metadata": payload.get("metadata", {}),
+    }
+
+    # Run the agent
+    result = agent.invoke(initial_state)
+
+    # Extract the final response
+    messages = result.get("messages", [])
+    final_message = messages[-1] if messages else None
+    final_response = final_message.content if final_message else "No response generated"
+
+    return {
+        "result": final_response,
+        "events": [
+            {"type": "agent_start", "query": payload.get("query")},
+            {"type": "agent_response", "content": final_response},
+        ],
+    }
+
+
+# Create a graph instance for direct use
+if LANGGRAPH_AVAILABLE:
+    graph = create_simple_agent()
+else:
+    graph = None
diff --git a/tests/integration/test_integration_basic.py b/tests/integration/test_integration_basic.py
new file mode 100644
index 0000000..14f5613
--- /dev/null
+++ b/tests/integration/test_integration_basic.py
@@ -0,0 +1,55 @@
+"""Basic integration test to verify test structure."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+
+
+@pytest.mark.integration
+def test_integration_directory_structure():
+    """Test that integration test directory is properly set up."""
+    integration_dir = Path(__file__).parent
+
+    # Check required files exist
+    assert (integration_dir / "__init__.py").exists()
+    assert (integration_dir / "conftest.py").exists()
+    assert (integration_dir / "simple_langgraph_agent.py").exists()
+    assert (integration_dir / "test_langgraph_integration.py").exists()
+    assert (integration_dir / "README.md").exists()
+
+
+@pytest.mark.integration
+def test_simple_langgraph_agent_fallback():
+    """Test that the simple agent works without LangGraph installed."""
+    from .simple_langgraph_agent import LANGGRAPH_AVAILABLE, invoke_agent
+
+    # Should work even without LangGraph (returns mock response)
+    payload = {
+        "query": "What is quantum tunneling?",
+        "context": ["Physics"],
+        "tools": ["search"],
+        "metadata": {},
+    }
+
+    result = invoke_agent(payload)
+
+    assert isinstance(result, dict)
+    assert "result" in result
+    assert "events" in result
+
+    if not LANGGRAPH_AVAILABLE:
+        # Should return mock response
+        assert "Mock response" in result["result"]
+
+    # Should contain the query in the response
+    assert "quantum" in result["result"].lower() or "Mock response" in result["result"]
+
+
+@pytest.mark.integration
+def test_pytest_markers_configured():
+    """Test that pytest markers are properly configured."""
+
+    # This test itself should have the integration marker
+    # We can't easily test this programmatically, but the test runner will validate it
diff --git a/tests/integration/test_langgraph_integration.py b/tests/integration/test_langgraph_integration.py
new file mode 100644
index 0000000..939edae
--- /dev/null
+++ b/tests/integration/test_langgraph_integration.py
@@ -0,0 +1,239 @@
+"""Integration tests for LangGraph with AgentUnit."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+
+from agentunit import Scenario, run_suite
+from agentunit.datasets.base import DatasetCase, DatasetSource
+
+
+# Skip all tests in this module if LangGraph is not available
+langgraph = pytest.importorskip("langgraph", reason="LangGraph not installed")
+
+
+class SimpleDataset(DatasetSource):
+    """Simple dataset for testing."""
+
+    def __init__(self):
+        """Initialize the simple dataset."""
+        super().__init__(name="simple-test-dataset", loader=self._generate_cases)
+
+    def _generate_cases(self):
+        """Generate test cases."""
+        return [
+            DatasetCase(
+                id="quantum-query",
+                query="What is quantum tunneling?",
+                expected_output="Quantum tunneling is a quantum mechanical phenomenon",
+                context=["Physics", "Quantum Mechanics"],
+                tools=["search"],
+                metadata={"difficulty": "intermediate"},
+            ),
+            DatasetCase(
+                id="python-query",
+                query="Tell me about Python programming",
+                expected_output="Python is a high-level programming language",
+                context=["Programming", "Software Development"],
+                tools=["documentation"],
+                metadata={"difficulty": "beginner"},
+            ),
+            DatasetCase(
+                id="weather-query",
+                query="What's the weather like today?",
+                expected_output="I would need access to weather APIs",
+                context=["Weather", "APIs"],
+                tools=["weather_api"],
+                metadata={"difficulty": "advanced"},
+            ),
+        ]
+
+
+@pytest.mark.langgraph
+@pytest.mark.integration
+class TestLangGraphIntegration:
+    """Integration tests for LangGraph adapter."""
+
+    def test_langgraph_scenario_from_callable(self):
+        """Test creating a scenario from a callable LangGraph agent."""
+        from .simple_langgraph_agent import invoke_agent
+
+        # Create scenario using the callable
+        scenario = Scenario.load_langgraph(
+            path=invoke_agent, dataset=SimpleDataset(), name="test-langgraph-callable"
+        )
+
+        assert scenario.name == "test-langgraph-callable"
+        assert scenario.adapter.name == "langgraph"
+
+        # Test that the scenario can be prepared
+        scenario.adapter.prepare()
+
+        # Test execution with a single case
+        test_case = DatasetCase(
+            id="test-case",
+            query="What is quantum tunneling?",
+            expected_output="",
+            context=["Physics"],
+            tools=["search"],
+            metadata={},
+        )
+
+        from agentunit.core.trace import TraceLog
+
+        trace = TraceLog()
+        outcome = scenario.adapter.execute(test_case, trace)
+
+        assert outcome.success is True
+        assert outcome.output is not None
+        assert "quantum" in outcome.output.lower()
+
+    def test_langgraph_scenario_from_python_file(self):
+        """Test creating a scenario from a Python file."""
+        # Create a temporary Python file with the agent
+        agent_file = Path("tests/integration/simple_langgraph_agent.py")
+
+        scenario = Scenario.load_langgraph(
+            path=agent_file,
+            dataset=SimpleDataset(),
+            name="test-langgraph-file",
+            callable="invoke_agent",  # Specify the callable name
+        )
+
+        assert scenario.name == "test-langgraph-file"
+        assert scenario.adapter.name == "langgraph"
+
+    def test_full_evaluation_cycle(self):
+        """Test running a full evaluation cycle with LangGraph."""
+        from .simple_langgraph_agent import invoke_agent
+
+        # Create scenario
+        scenario = Scenario.load_langgraph(
+            path=invoke_agent, dataset=SimpleDataset(), name="full-cycle-test"
+        )
+
+        # Run the evaluation
+        result = run_suite([scenario])
+
+        # Verify results
+        assert len(result.scenarios) == 1
+        scenario_result = result.scenarios[0]
+
+        assert scenario_result.name == "full-cycle-test"
+        assert len(scenario_result.runs) == 3  # Three test cases in SimpleDataset
+
+        # Check that all runs completed
+        for run in scenario_result.runs:
+            assert run.success is True
+            assert run.duration_ms > 0
+            assert run.error is None
+
+    def test_scenario_with_metrics(self):
+        """Test running scenario with metrics evaluation."""
+        from .simple_langgraph_agent import invoke_agent
+
+        scenario = Scenario.load_langgraph(
+            path=invoke_agent, dataset=SimpleDataset(), name="metrics-test"
+        )
+
+        # Run with basic metrics (if available)
+        result = run_suite([scenario], metrics=["faithfulness"])
+
+        scenario_result = result.scenarios[0]
+
+        # Check that metrics were calculated (or gracefully handled if not available)
+        for run in scenario_result.runs:
+            assert isinstance(run.metrics, dict)
+
+    def test_scenario_error_handling(self):
+        """Test that scenarios handle errors gracefully."""
+
+        def failing_agent(payload):
+            """An agent that always fails."""
+            raise ValueError("Simulated agent failure")
+
+        scenario = Scenario.load_langgraph(
+            path=failing_agent, dataset=SimpleDataset(), name="error-test"
+        )
+
+        result = run_suite([scenario])
+        scenario_result = result.scenarios[0]
+
+        # All runs should fail but be recorded
+        for run in scenario_result.runs:
+            assert run.success is False
+            assert run.error is not None
+            assert "Simulated agent failure" in run.error
+
+    def test_scenario_with_retries(self):
+        """Test scenario retry functionality."""
+        from .simple_langgraph_agent import invoke_agent
+
+        scenario = Scenario.load_langgraph(
+            path=invoke_agent, dataset=SimpleDataset(), name="retry-test"
+        )
+
+        # Set retries
+        scenario.retries = 2
+
+        result = run_suite([scenario])
+        scenario_result = result.scenarios[0]
+
+        # Should still succeed (our agent doesn't fail)
+        for run in scenario_result.runs:
+            assert run.success is True
+
+    def test_scenario_clone_and_modify(self):
+        """Test cloning and modifying scenarios."""
+        from .simple_langgraph_agent import invoke_agent
+
+        original = Scenario.load_langgraph(
+            path=invoke_agent, dataset=SimpleDataset(), name="original"
+        )
+
+        # Clone with modifications
+        cloned = original.clone(name="cloned", retries=3, timeout=120.0)
+
+        assert cloned.name == "cloned"
+        assert cloned.retries == 3
+        assert cloned.timeout == 120.0
+        assert original.name == "original"  # Original unchanged
+        assert original.retries == 1  # Default value
+
+
+@pytest.mark.langgraph
+@pytest.mark.integration
+def test_langgraph_adapter_registry():
+    """Test that LangGraph adapter is properly registered."""
+    from agentunit.adapters.langgraph import LangGraphAdapter
+    from agentunit.adapters.registry import resolve_adapter
+
+    adapter_class = resolve_adapter("langgraph")
+    assert adapter_class is LangGraphAdapter
+
+    # Test alias
+    adapter_class = resolve_adapter("langgraph_graph")
+    assert adapter_class is LangGraphAdapter
+
+
+@pytest.mark.langgraph
+@pytest.mark.integration
+def test_multiple_scenarios():
+    """Test running multiple LangGraph scenarios together."""
+    from .simple_langgraph_agent import invoke_agent
+
+    # Create multiple scenarios
+    scenarios = [
+        Scenario.load_langgraph(path=invoke_agent, dataset=SimpleDataset(), name=f"scenario-{i}")
+        for i in range(3)
+    ]
+
+    # Run all scenarios
+    result = run_suite(scenarios)
+
+    assert len(result.scenarios) == 3
+    for i, scenario_result in enumerate(result.scenarios):
+        assert scenario_result.name == f"scenario-{i}"
+        assert len(scenario_result.runs) == 3  # Each has 3 test cases