easy-agentic-plugin 0.1.0__tar.gz

easy_agentic_plugin-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 limenghua
+
+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.

easy_agentic_plugin-0.1.0/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: easy-agentic-plugin
+Version: 0.1.0
+Summary: A plugin framework for agents, built on LangGraph deepagents + langgraph-cli.
+Keywords: agent,llm,langgraph,deepagents,plugin,langchain
+Author: limenghua
+Author-email: limenghua <576566385@qq.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Dist: deepagents>=0.6.10
+Requires-Dist: langchain-core>=1.4.7
+Requires-Dist: langgraph>=1.2.5
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: langchain-anthropic>=1.4.6 ; extra == 'all'
+Requires-Dist: langchain-openai>=1.3.2 ; extra == 'all'
+Requires-Dist: langgraph-cli[inmem]>=0.4.29 ; extra == 'all'
+Requires-Dist: langchain-anthropic>=1.4.6 ; extra == 'anthropic'
+Requires-Dist: langgraph-cli[inmem]>=0.4.29 ; extra == 'cli'
+Requires-Dist: langchain-openai>=1.3.2 ; extra == 'openai'
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/easy-agentic/easy-agentic-plugin
+Project-URL: Repository, https://github.com/easy-agentic/easy-agentic-plugin
+Provides-Extra: all
+Provides-Extra: anthropic
+Provides-Extra: cli
+Provides-Extra: openai
+Description-Content-Type: text/markdown
+
+# easy-agentic-plugin
+
+An Agent-oriented **plugin framework**: it provides a unified extension-injection mechanism for agents built on top of LangGraph **deepagents** + **langgraph-cli**. Every extension (agent / tool / skill / filesystem / middleware / model, …) is wired in through plugins.
+
+> It is **not** a business agent, and it does not implement a runtime or a serving container — those are handled by deepagents and langgraph-cli respectively.
+> For the detailed positioning and design, see [doc/requirement.md](doc/requirement.md) and [doc/architecture.md](doc/architecture.md).
+
+## Tech stack
+
+- Python **3.12** (pinned via uv)
+- Package / environment management: **uv**
+- Agent runtime: **deepagents**; serving / interface: **langgraph-cli** (agent server)
+- LLM direction: **Claude** (`langchain-anthropic`)
+
+---
+
+## Quick start
+
+```bash
+# 1. Install uv (if not already installed)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# 2. Sync dependencies (install everything from uv.lock into .venv)
+uv sync
+
+# 3. Configure environment variables: copy the .env template and fill in API keys, etc.
+#    (.env is git-ignored — never commit real secrets)
+
+# 4. Start the local agent server (LangGraph Studio)
+uv run langgraph dev
+# Defaults to http://127.0.0.1:2024
+```
+
+---
+
+## Using easy-agentic-plugin as a library
+
+easy-agentic-plugin is published as an importable library. In a consumer project:
+
+```bash
+pip install easy-agentic-plugin          # core only
+pip install easy-agentic-plugin[cli]     # + langgraph-cli for `langgraph dev`
+pip install easy-agentic-plugin[all]     # + Anthropic/OpenAI providers + CLI
+```
+
+Point your own `langgraph.json` at the built-in global router graph:
+
+```json
+{
+  "dependencies": ["."],
+  "graphs": { "agent": "easy_agentic_plugin.graph:main" },
+  "env": ".env"
+}
+```
+
+Then drop in your own `agents/` and `plugins/` directories. Prefer to compose the graph
+yourself? Use the `build_graph()` factory exported from the top-level package.
+
+Optional extras:
+
+| Extra | Pulls in | Use when |
+| --- | --- | --- |
+| `anthropic` | `langchain-anthropic` | serving Claude models |
+| `openai` | `langchain-openai` | serving OpenAI models |
+| `cli` | `langgraph-cli[inmem]` | running `langgraph dev` / building an image |
+| `all` | all of the above | one-shot install |
+
+---
+
+## How uv is used
+
+uv is a single tool that handles **Python version + virtual environment + dependencies + running**: it reads `pyproject.toml` (declared dependencies) → resolves `uv.lock` (pinned exact versions) → syncs them into `.venv`. Day to day you **do not need to activate the virtual environment manually** — just use `uv run`.
+
+### Most-used commands
+
+| Command | What it does | When |
+| --- | --- | --- |
+| `uv add <pkg>` | Add a runtime dependency (writes to pyproject and installs) | When you need a library (**don't hand-edit pyproject**) |
+| `uv add --dev <pkg>` | Add a dev dependency (pytest, ruff, …) | Tooling used only for dev/test |
+| `uv remove <pkg>` | Remove a dependency | When no longer needed |
+| `uv run <cmd>` | Run a command inside the project env | Everything: `uv run pytest`, `uv run langgraph dev` |
+| `uv sync` | Reconcile `.venv` with `uv.lock` | After pulling code / switching environments |
+
+> 90% of the time you'll only use **`uv add`** and **`uv run`**.
+
+### Key points
+
+- **Dependencies are managed only through `uv add`** — don't hand-edit the `dependencies` in `pyproject.toml`; exact versions are pinned in `uv.lock` (kept under version control).
+- **`uv run` implicitly syncs** the environment before executing, so after adding a dependency you can run `uv run` directly — no need to `uv sync` first.
+- **No `pip install`, no `source .venv/bin/activate`** — uv prepares the environment for the subprocess automatically.
+- **Python version** is pinned to 3.12 by `.python-version`; uv selects the matching interpreter automatically.
+
+### How `uv run` works internally (in brief)
+
+`uv run X` ≈ "ensure the environment matches the lock" + "temporarily activate `.venv`" + "run X". X ultimately resolves to an executable under `.venv/bin/` bound to this project's interpreter:
+
+- `uv run pytest` → runs `.venv/bin/pytest` (an entry-point script generated at install time, whose shebang points at the project `.venv` python)
+- `uv run python foo.py` → runs `foo.py` with `.venv/bin/python`
+
+Handy flags: `--no-sync` (skip syncing), `--frozen` (don't re-resolve), `--locked` (require the lock to be up to date, good for CI).
+
+---
+
+## Common development commands
+
+```bash
+uv run langgraph dev          # Start the local agent server (entry graph: easy_agentic_plugin.graph:main)
+uv run pytest                 # Run tests
+uv add <pkg> / uv add --dev <pkg>   # Add dependencies
+uv sync                       # Sync the environment
+```
+
+## Project documentation
+
+- [CLAUDE.md](CLAUDE.md) — project constitution (for AI collaborators)
+- [doc/](doc/) — requirements, architecture, conventions, roadmap, decision records (ADRs)
+
+> The documents under `doc/` are kept in Chinese as the design/working record.

easy_agentic_plugin-0.1.0/README.md

@@ -0,0 +1,118 @@
+# easy-agentic-plugin
+
+An Agent-oriented **plugin framework**: it provides a unified extension-injection mechanism for agents built on top of LangGraph **deepagents** + **langgraph-cli**. Every extension (agent / tool / skill / filesystem / middleware / model, …) is wired in through plugins.
+
+> It is **not** a business agent, and it does not implement a runtime or a serving container — those are handled by deepagents and langgraph-cli respectively.
+> For the detailed positioning and design, see [doc/requirement.md](doc/requirement.md) and [doc/architecture.md](doc/architecture.md).
+
+## Tech stack
+
+- Python **3.12** (pinned via uv)
+- Package / environment management: **uv**
+- Agent runtime: **deepagents**; serving / interface: **langgraph-cli** (agent server)
+- LLM direction: **Claude** (`langchain-anthropic`)
+
+---
+
+## Quick start
+
+```bash
+# 1. Install uv (if not already installed)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# 2. Sync dependencies (install everything from uv.lock into .venv)
+uv sync
+
+# 3. Configure environment variables: copy the .env template and fill in API keys, etc.
+#    (.env is git-ignored — never commit real secrets)
+
+# 4. Start the local agent server (LangGraph Studio)
+uv run langgraph dev
+# Defaults to http://127.0.0.1:2024
+```
+
+---
+
+## Using easy-agentic-plugin as a library
+
+easy-agentic-plugin is published as an importable library. In a consumer project:
+
+```bash
+pip install easy-agentic-plugin          # core only
+pip install easy-agentic-plugin[cli]     # + langgraph-cli for `langgraph dev`
+pip install easy-agentic-plugin[all]     # + Anthropic/OpenAI providers + CLI
+```
+
+Point your own `langgraph.json` at the built-in global router graph:
+
+```json
+{
+  "dependencies": ["."],
+  "graphs": { "agent": "easy_agentic_plugin.graph:main" },
+  "env": ".env"
+}
+```
+
+Then drop in your own `agents/` and `plugins/` directories. Prefer to compose the graph
+yourself? Use the `build_graph()` factory exported from the top-level package.
+
+Optional extras:
+
+| Extra | Pulls in | Use when |
+| --- | --- | --- |
+| `anthropic` | `langchain-anthropic` | serving Claude models |
+| `openai` | `langchain-openai` | serving OpenAI models |
+| `cli` | `langgraph-cli[inmem]` | running `langgraph dev` / building an image |
+| `all` | all of the above | one-shot install |
+
+---
+
+## How uv is used
+
+uv is a single tool that handles **Python version + virtual environment + dependencies + running**: it reads `pyproject.toml` (declared dependencies) → resolves `uv.lock` (pinned exact versions) → syncs them into `.venv`. Day to day you **do not need to activate the virtual environment manually** — just use `uv run`.
+
+### Most-used commands
+
+| Command | What it does | When |
+| --- | --- | --- |
+| `uv add <pkg>` | Add a runtime dependency (writes to pyproject and installs) | When you need a library (**don't hand-edit pyproject**) |
+| `uv add --dev <pkg>` | Add a dev dependency (pytest, ruff, …) | Tooling used only for dev/test |
+| `uv remove <pkg>` | Remove a dependency | When no longer needed |
+| `uv run <cmd>` | Run a command inside the project env | Everything: `uv run pytest`, `uv run langgraph dev` |
+| `uv sync` | Reconcile `.venv` with `uv.lock` | After pulling code / switching environments |
+
+> 90% of the time you'll only use **`uv add`** and **`uv run`**.
+
+### Key points
+
+- **Dependencies are managed only through `uv add`** — don't hand-edit the `dependencies` in `pyproject.toml`; exact versions are pinned in `uv.lock` (kept under version control).
+- **`uv run` implicitly syncs** the environment before executing, so after adding a dependency you can run `uv run` directly — no need to `uv sync` first.
+- **No `pip install`, no `source .venv/bin/activate`** — uv prepares the environment for the subprocess automatically.
+- **Python version** is pinned to 3.12 by `.python-version`; uv selects the matching interpreter automatically.
+
+### How `uv run` works internally (in brief)
+
+`uv run X` ≈ "ensure the environment matches the lock" + "temporarily activate `.venv`" + "run X". X ultimately resolves to an executable under `.venv/bin/` bound to this project's interpreter:
+
+- `uv run pytest` → runs `.venv/bin/pytest` (an entry-point script generated at install time, whose shebang points at the project `.venv` python)
+- `uv run python foo.py` → runs `foo.py` with `.venv/bin/python`
+
+Handy flags: `--no-sync` (skip syncing), `--frozen` (don't re-resolve), `--locked` (require the lock to be up to date, good for CI).
+
+---
+
+## Common development commands
+
+```bash
+uv run langgraph dev          # Start the local agent server (entry graph: easy_agentic_plugin.graph:main)
+uv run pytest                 # Run tests
+uv add <pkg> / uv add --dev <pkg>   # Add dependencies
+uv sync                       # Sync the environment
+```
+
+## Project documentation
+
+- [CLAUDE.md](CLAUDE.md) — project constitution (for AI collaborators)
+- [doc/](doc/) — requirements, architecture, conventions, roadmap, decision records (ADRs)
+
+> The documents under `doc/` are kept in Chinese as the design/working record.

easy_agentic_plugin-0.1.0/pyproject.toml

@@ -0,0 +1,84 @@
+[project]
+name = "easy-agentic-plugin"
+version = "0.1.0"
+description = "A plugin framework for agents, built on LangGraph deepagents + langgraph-cli."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "limenghua", email = "576566385@qq.com" }]
+keywords = ["agent", "llm", "langgraph", "deepagents", "plugin", "langchain"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+# 硬依赖：框架代码真正 import 的最小集合。
+dependencies = [
+    "deepagents>=0.6.10",
+    "langchain-core>=1.4.7",
+    "langgraph>=1.2.5",
+    "pyyaml>=6.0",
+]
+
+# 可选能力：按需 `pip install easy-agentic[anthropic,cli]`。
+# provider 包与 langgraph-cli 框架本身不 import，交给使用方按 model / serve 需求选装。
+[project.optional-dependencies]
+anthropic = ["langchain-anthropic>=1.4.6"]
+openai = ["langchain-openai>=1.3.2"]
+cli = ["langgraph-cli[inmem]>=0.4.29"]
+all = [
+    "langchain-anthropic>=1.4.6",
+    "langchain-openai>=1.3.2",
+    "langgraph-cli[inmem]>=0.4.29",
+]
+
+[project.urls]
+Homepage = "https://github.com/easy-agentic/easy-agentic-plugin"
+Repository = "https://github.com/easy-agentic/easy-agentic-plugin"
+
+[build-system]
+requires = ["uv_build>=0.11.21,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "easy_agentic_plugin"
+module-root = "src"
+
+[dependency-groups]
+dev = [
+    "debugpy>=1.8.21",
+    "pytest>=9.1.0",
+    "pytest-asyncio>=1.4.0",
+    "ruff>=0.9.0",
+    "mypy>=1.15.0",
+    # 本仓库自身也是「示例 app」：跑 langgraph dev / example agent 需要 provider 与 CLI。
+    # 库把它们做成 extras；这里在 dev 环境里直接装齐，保持本地开发体验不变。
+    "langchain-anthropic>=1.4.6",
+    "langchain-openai>=1.3.2",
+    "langchain-community>=0.4.2",
+    "langgraph-cli[inmem]>=0.4.29",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+asyncio_mode = "auto"
+addopts = "-ra -q"
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+
+[tool.ruff.lint]
+# 温和起步：pycodestyle(E)/pyflakes(F)/isort(I)/pyupgrade(UP)/flake8-bugbear(B)。
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.mypy]
+python_version = "3.12"
+files = ["src"]
+# 三方库（deepagents/langgraph/langchain 等）stub 不全，先忽略缺失 import 的噪音。
+ignore_missing_imports = true

easy_agentic_plugin-0.1.0/src/easy_agentic_plugin/__init__.py

@@ -0,0 +1,47 @@
+"""easy-agentic-plugin -- an Agent-oriented plugin framework (core package)."""
+
+from __future__ import annotations
+
+from .application import (
+    Application,
+    build_folder_kwargs,
+    compose_backend,
+    discover_plugins,
+    get_application,
+)
+from .config import Config
+from .context import AgentBuildContext, AppContext
+from .contribution import AgentContribution
+from .errors import ConflictError, EasyAgenticError, UnknownReferenceError
+from .folder import FolderAgentError, FolderSpec, load_folder_spec
+from .graph import build_graph
+from .merge import merge_contributions
+from .plugin import Plugin, PluginBase
+from .registry import NamedRegistry
+from .sources import AgentSource, FolderAgent, GraphFactory
+
+__all__ = [
+    "AgentBuildContext",
+    "AgentContribution",
+    "AgentSource",
+    "AppContext",
+    "Application",
+    "Config",
+    "ConflictError",
+    "EasyAgenticError",
+    "FolderAgent",
+    "FolderAgentError",
+    "FolderSpec",
+    "GraphFactory",
+    "NamedRegistry",
+    "Plugin",
+    "PluginBase",
+    "UnknownReferenceError",
+    "build_folder_kwargs",
+    "build_graph",
+    "compose_backend",
+    "discover_plugins",
+    "get_application",
+    "load_folder_spec",
+    "merge_contributions",
+]