langgraph-hierarchies 0.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. langgraph_hierarchies-0.0.1/.gitignore +63 -0
  2. langgraph_hierarchies-0.0.1/LICENSE +21 -0
  3. langgraph_hierarchies-0.0.1/PKG-INFO +87 -0
  4. langgraph_hierarchies-0.0.1/README.md +64 -0
  5. langgraph_hierarchies-0.0.1/pyproject.toml +72 -0
  6. langgraph_hierarchies-0.0.1/src/langgraph_hierarchies/__init__.py +3 -0
  7. langgraph_hierarchies-0.0.1/tests/test_version.py +7 -0
  8. langgraph_hierarchies-0.0.1/uv.lock +1554 -0
langgraph_hierarchies-0.0.1/.gitignore ADDED
@@ -0,0 +1,63 @@
1
+ # ── Portfolio infrastructure ──────────────────────────────────────────────────
2
+
3
+ # Agent knowledge (symlinked from project-kbs — dir or symlink)
4
+ .agents
5
+ .agents/
6
+
7
+ # Cursor compat (generated from .agents/)
8
+ .cursor
9
+ .cursor/
10
+
11
+ # MCP config (local secrets — dir or symlink)
12
+ .mcp
13
+ .mcp/
14
+
15
+ # GitHub Actions / workflows (local only)
16
+ .github
17
+ .github/
18
+
19
+ .config
20
+ .config/
21
+
22
+ # ── Secrets ───────────────────────────────────────────────────────────────────
23
+
24
+ .env
25
+ *.env
26
+
27
+ # ── Python ────────────────────────────────────────────────────────────────────
28
+
29
+ __pycache__/
30
+ **/__pycache__/
31
+ *.py[cod]
32
+ *.pyo
33
+
34
+ # Virtual environments
35
+ .venv/
36
+ venv/
37
+ env/
38
+ .env/
39
+
40
+ # Distribution / packaging
41
+ dist/
42
+ build/
43
+ *.egg-info/
44
+ *.egg
45
+
46
+ # Test and type-check caches
47
+ .pytest_cache/
48
+ .mypy_cache/
49
+ .ruff_cache/
50
+ .cache/
51
+
52
+ # Coverage
53
+ .coverage
54
+ coverage.xml
55
+ htmlcov/
56
+
57
+ # Jupyter
58
+ .ipynb_checkpoints/
59
+
60
+ # ── OS ────────────────────────────────────────────────────────────────────────
61
+
62
+ **/.DS_Store
63
+ Thumbs.db
langgraph_hierarchies-0.0.1/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 korrino222
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
langgraph_hierarchies-0.0.1/PKG-INFO ADDED
@@ -0,0 +1,87 @@
1
+ Metadata-Version: 2.4
2
+ Name: langgraph-hierarchies
3
+ Version: 0.0.1
4
+ Summary: LangGraph abstractions for hierarchical multi-agent systems
5
+ Project-URL: Homepage, https://github.com/korrino222/langgraph-hierarchies
6
+ Project-URL: Repository, https://github.com/korrino222/langgraph-hierarchies
7
+ Project-URL: Issues, https://github.com/korrino222/langgraph-hierarchies/issues
8
+ Project-URL: Changelog, https://github.com/korrino222/langgraph-hierarchies/releases
9
+ License-Expression: MIT
10
+ License-File: LICENSE
11
+ Classifier: Development Status :: 3 - Alpha
12
+ Classifier: License :: OSI Approved :: MIT License
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3 :: Only
15
+ Classifier: Programming Language :: Python :: 3.10
16
+ Classifier: Programming Language :: Python :: 3.11
17
+ Classifier: Programming Language :: Python :: 3.12
18
+ Classifier: Programming Language :: Python :: 3.13
19
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
20
+ Requires-Python: >=3.10
21
+ Requires-Dist: langgraph<2.0.0,>=1.2.6
22
+ Description-Content-Type: text/markdown
23
+
24
+ # langgraph-hierarchies
25
+
26
+ **Status: early development (0.0.x).** API and scope are not stable. v0.1 will ship the keystone slice below.
27
+
28
+ Stateful, deeply-nested **compiled-subgraph** agent hierarchies on [LangGraph](https://github.com/langchain-ai/langgraph) — with declarative per-subchain state isolation and supervisor-controlled iteration safety.
29
+
30
+ Flat delegation (Deep Agents, supervisor handoffs) is a good starting point. This library targets the production wall past that: recursive hierarchies where subagents are **real compiled subgraphs**, with explicit clear/merge/discard policy across satte fields — not ephemeral `task`-tool isolation alone.
31
+
32
+ ## How this relates to other libraries
33
+
34
+ | | [langgraph-supervisor](https://pypi.org/project/langgraph-supervisor/) | [Deep Agents](https://pypi.org/project/deepagents/) | langgraph-hierarchies |
35
+ | --- | --- | --- | --- |
36
+ | Model | Supervisor → workers (handoff tools) | Harness + subagents (`task` / programmatic `task()`) | Class-as-factory graphs, phased compile, `SubchainPolicy` |
37
+ | Nesting | Multi-level supervisors | Fan-out / data recursion (partial); not stateful deep trees | Recursive compiled subgraphs + declarative state policy |
38
+ | Best for | Quick hierarchical routing | General long-horizon agents | Production-grade deep hierarchies with accountability |
39
+
40
+ Deep Agents already covers fan-out, parallel orchestration, and RLM-style recursion over data ([programmatic subagents](https://docs.langchain.com/oss/python/deepagents/programmatic-subagents), June 2026). This project does **not** try to replace that.
41
+
42
+ ## Compatibility
43
+
44
+ | langgraph-hierarchies | langgraph |
45
+ | --- | --- |
46
+ | 0.0.x | 1.2.6 (pinned; see [releases](https://github.com/korrino222/langgraph-hierarchies/releases)) |
47
+
48
+ Regression tests will gate version bumps. A pair is listed here only once the test suite is green for it.
49
+
50
+ ## Roadmap (v0.1)
51
+
52
+ - [ ] `BaseGraph` / `CompiledGraph` + phased compilation
53
+ - [ ] `SubchainPolicy` (entry snapshot, clear/merge/discard, exit restore)
54
+ - [ ] `ReactGraph` + iteration safety (per-agent limits, supervisor `task_iterations`, forced-exit report)
55
+ - [ ] Minimal runnable hierarchy example
56
+
57
+ Planner/Executor, progress tracking, HITL: follow-on after v0.1.
58
+
59
+ ## Install
60
+
61
+ ```bash
62
+ pip install langgraph-hierarchies
63
+ ```
64
+
65
+ Requires Python ≥3.10 (matches [LangGraph](https://pypi.org/project/langgraph/)).
66
+
67
+ ### Development
68
+
69
+ Uses [uv](https://docs.astral.sh/uv/) (same toolchain as upstream LangGraph):
70
+
71
+ ```bash
72
+ uv sync
73
+ uv run pytest
74
+ uv build # sdist + wheel for PyPI
75
+ ```
76
+
77
+ ## Disclaimer
78
+
79
+ This project is **not affiliated with, endorsed by, or maintained by** LangChain or the LangGraph team. “LangGraph” is a trademark of LangChain; this package name indicates compatibility with the LangGraph runtime, not official status.
80
+
81
+ ## Contact
82
+
83
+ - **Bug reports & feature requests:** [GitHub Issues](https://github.com/korrino222/langgraph-hierarchies/issues)
84
+
85
+ ## License
86
+
87
+ MIT — see [LICENSE](https://github.com/korrino222/langgraph-hierarchies/blob/main/LICENSE).
langgraph_hierarchies-0.0.1/README.md ADDED
@@ -0,0 +1,64 @@
1
+ # langgraph-hierarchies
2
+
3
+ **Status: early development (0.0.x).** API and scope are not stable. v0.1 will ship the keystone slice below.
4
+
5
+ Stateful, deeply-nested **compiled-subgraph** agent hierarchies on [LangGraph](https://github.com/langchain-ai/langgraph) — with declarative per-subchain state isolation and supervisor-controlled iteration safety.
6
+
7
+ Flat delegation (Deep Agents, supervisor handoffs) is a good starting point. This library targets the production wall past that: recursive hierarchies where subagents are **real compiled subgraphs**, with explicit clear/merge/discard policy across satte fields — not ephemeral `task`-tool isolation alone.
8
+
9
+ ## How this relates to other libraries
10
+
11
+ | | [langgraph-supervisor](https://pypi.org/project/langgraph-supervisor/) | [Deep Agents](https://pypi.org/project/deepagents/) | langgraph-hierarchies |
12
+ | --- | --- | --- | --- |
13
+ | Model | Supervisor → workers (handoff tools) | Harness + subagents (`task` / programmatic `task()`) | Class-as-factory graphs, phased compile, `SubchainPolicy` |
14
+ | Nesting | Multi-level supervisors | Fan-out / data recursion (partial); not stateful deep trees | Recursive compiled subgraphs + declarative state policy |
15
+ | Best for | Quick hierarchical routing | General long-horizon agents | Production-grade deep hierarchies with accountability |
16
+
17
+ Deep Agents already covers fan-out, parallel orchestration, and RLM-style recursion over data ([programmatic subagents](https://docs.langchain.com/oss/python/deepagents/programmatic-subagents), June 2026). This project does **not** try to replace that.
18
+
19
+ ## Compatibility
20
+
21
+ | langgraph-hierarchies | langgraph |
22
+ | --- | --- |
23
+ | 0.0.x | 1.2.6 (pinned; see [releases](https://github.com/korrino222/langgraph-hierarchies/releases)) |
24
+
25
+ Regression tests will gate version bumps. A pair is listed here only once the test suite is green for it.
26
+
27
+ ## Roadmap (v0.1)
28
+
29
+ - [ ] `BaseGraph` / `CompiledGraph` + phased compilation
30
+ - [ ] `SubchainPolicy` (entry snapshot, clear/merge/discard, exit restore)
31
+ - [ ] `ReactGraph` + iteration safety (per-agent limits, supervisor `task_iterations`, forced-exit report)
32
+ - [ ] Minimal runnable hierarchy example
33
+
34
+ Planner/Executor, progress tracking, HITL: follow-on after v0.1.
35
+
36
+ ## Install
37
+
38
+ ```bash
39
+ pip install langgraph-hierarchies
40
+ ```
41
+
42
+ Requires Python ≥3.10 (matches [LangGraph](https://pypi.org/project/langgraph/)).
43
+
44
+ ### Development
45
+
46
+ Uses [uv](https://docs.astral.sh/uv/) (same toolchain as upstream LangGraph):
47
+
48
+ ```bash
49
+ uv sync
50
+ uv run pytest
51
+ uv build # sdist + wheel for PyPI
52
+ ```
53
+
54
+ ## Disclaimer
55
+
56
+ This project is **not affiliated with, endorsed by, or maintained by** LangChain or the LangGraph team. “LangGraph” is a trademark of LangChain; this package name indicates compatibility with the LangGraph runtime, not official status.
57
+
58
+ ## Contact
59
+
60
+ - **Bug reports & feature requests:** [GitHub Issues](https://github.com/korrino222/langgraph-hierarchies/issues)
61
+
62
+ ## License
63
+
64
+ MIT — see [LICENSE](https://github.com/korrino222/langgraph-hierarchies/blob/main/LICENSE).
langgraph_hierarchies-0.0.1/pyproject.toml ADDED
@@ -0,0 +1,72 @@
1
+ [build-system]
2
+ requires = ["hatchling"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "langgraph-hierarchies"
7
+ version = "0.0.1"
8
+ description = "LangGraph abstractions for hierarchical multi-agent systems"
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ license = "MIT"
12
+ license-files = ["LICENSE"]
13
+ classifiers = [
14
+ "Development Status :: 3 - Alpha",
15
+ "License :: OSI Approved :: MIT License",
16
+ "Programming Language :: Python :: 3",
17
+ "Programming Language :: Python :: 3 :: Only",
18
+ "Programming Language :: Python :: 3.10",
19
+ "Programming Language :: Python :: 3.11",
20
+ "Programming Language :: Python :: 3.12",
21
+ "Programming Language :: Python :: 3.13",
22
+ "Topic :: Software Development :: Libraries :: Python Modules",
23
+ ]
24
+ dependencies = [
25
+ "langgraph>=1.2.6,<2.0.0",
26
+ ]
27
+
28
+ [project.urls]
29
+ Homepage = "https://github.com/korrino222/langgraph-hierarchies"
30
+ Repository = "https://github.com/korrino222/langgraph-hierarchies"
31
+ Issues = "https://github.com/korrino222/langgraph-hierarchies/issues"
32
+ Changelog = "https://github.com/korrino222/langgraph-hierarchies/releases"
33
+
34
+ [tool.portfolio]
35
+ owner = "korrino222"
36
+ repo = "langgraph-hierarchies"
37
+ status = "active"
38
+
39
+ [dependency-groups]
40
+ test = [
41
+ "pytest>=8.0",
42
+ "pytest-cov",
43
+ ]
44
+ lint = [
45
+ "ruff>=0.9",
46
+ ]
47
+ dev = [
48
+ {include-group = "test"},
49
+ {include-group = "lint"},
50
+ "pre-commit>=4.0",
51
+ ]
52
+
53
+ [tool.uv]
54
+ default-groups = ["dev"]
55
+
56
+ [tool.hatch.build.targets.wheel]
57
+ packages = ["src/langgraph_hierarchies"]
58
+
59
+ [tool.ruff]
60
+ line-length = 88
61
+ target-version = "py310"
62
+
63
+ [tool.ruff.lint]
64
+ select = ["E", "F", "I", "UP", "B"]
65
+ ignore = ["E501"]
66
+
67
+ [tool.pytest.ini_options]
68
+ testpaths = ["tests"]
69
+ addopts = "--strict-markers --strict-config"
70
+
71
+ [tool.coverage.run]
72
+ source = ["langgraph_hierarchies"]
langgraph_hierarchies-0.0.1/src/langgraph_hierarchies/__init__.py ADDED
@@ -0,0 +1,3 @@
1
+ """LangGraph abstractions for hierarchical multi-agent systems."""
2
+
3
+ __version__ = "0.0.1"
langgraph_hierarchies-0.0.1/tests/test_version.py ADDED
@@ -0,0 +1,7 @@
1
+ """Smoke tests for package metadata."""
2
+
3
+ import langgraph_hierarchies
4
+
5
+
6
+ def test_version() -> None:
7
+ assert langgraph_hierarchies.__version__ == "0.0.1"