langchain-agentkit 0.4.0__tar.gz

langchain_agentkit-0.4.0/.github/workflows/ci.yml

@@ -0,0 +1,50 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ["3.11", "3.13"]
+    name: Test (Python ${{ matrix.python }})
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Install Python
+        run: uv python install ${{ matrix.python }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests
+        run: uv run pytest --tb=short -q
+
+  lint:
+    runs-on: ubuntu-latest
+    name: Lint & Types
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Install Python
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Ruff check
+        run: uv run ruff check src/ tests/
+
+      - name: Ruff format
+        run: uv run ruff format --check src/ tests/
+
+      - name: Mypy
+        run: uv run mypy src/

langchain_agentkit-0.4.0/.github/workflows/publish.yml

@@ -0,0 +1,31 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    name: Build & Publish
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Install Python
+        run: uv python install 3.13
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish --trusted-publishing always
+
+      - name: Create GitHub Release
+        run: gh release create ${{ github.ref_name }} dist/* --generate-notes
+        env:
+          GH_TOKEN: ${{ github.token }}

langchain_agentkit-0.4.0/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+.pytest_cache/
+.ruff_cache/
+*.egg
+.env
+.start/

langchain_agentkit-0.4.0/LICENSE

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

langchain_agentkit-0.4.0/PKG-INFO

@@ -0,0 +1,300 @@
+Metadata-Version: 2.4
+Name: langchain-agentkit
+Version: 0.4.0
+Summary: Composable middleware framework for LangGraph agents
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: langchain-core>=0.3
+Requires-Dist: langgraph>=0.4
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: langchain-openai>=0.3; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# langchain-agentkit
+
+Composable middleware framework for LangGraph agents.
+
+[![Python](https://img.shields.io/pypi/pyversions/langchain-agentkit.svg)](https://pypi.org/project/langchain-agentkit/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Build LangGraph agents with reusable middleware that composes tools and prompts. Two layers to choose from:
+
+- **`agent` metaclass** — declare a class, get a complete ReAct agent with middleware-composed tools and prompts
+- **`AgentKit`** — primitive composition engine for full control over graph topology
+
+> **Migrating from `langchain-skillkit`?** See [Migration](#migrating-from-langchain-skillkit) below. The old import path still works with a deprecation warning.
+
+## Installation
+
+Requires **Python 3.11+**, `langchain-core>=0.3`, `langgraph>=0.4`.
+
+```bash
+pip install langchain-agentkit
+```
+
+## Quick Start
+
+### The `agent` metaclass (recommended)
+
+Declare a class that inherits from `agent` to get a `StateGraph` with an automatic ReAct loop:
+
+```python
+from langchain_core.messages import HumanMessage, SystemMessage
+from langchain_openai import ChatOpenAI
+from langchain_agentkit import agent, SkillsMiddleware, TasksMiddleware
+
+class researcher(agent):
+    llm = ChatOpenAI(model="gpt-4o")
+    tools = [web_search]
+    middleware = [SkillsMiddleware("skills/"), TasksMiddleware()]
+    prompt = "You are a research assistant."
+
+    async def handler(state, *, llm, prompt):
+        messages = [SystemMessage(content=prompt)] + state["messages"]
+        response = await llm.ainvoke(messages)
+        return {"messages": [response], "sender": "researcher"}
+
+# Compile and use
+graph = researcher.compile()
+result = graph.invoke({"messages": [HumanMessage("Size the B2B SaaS market")]})
+
+# With checkpointer for interrupt() support
+from langgraph.checkpoint.memory import InMemorySaver
+graph = researcher.compile(checkpointer=InMemorySaver())
+```
+
+### `AgentKit` for manual graph wiring
+
+Use `AgentKit` when you need full control over graph topology — multi-node graphs, shared `ToolNode`, custom routing:
+
+```python
+from langchain_agentkit import AgentKit, SkillsMiddleware, TasksMiddleware
+
+kit = AgentKit([
+    SkillsMiddleware("skills/"),
+    TasksMiddleware(),
+])
+
+# In any graph node:
+all_tools = my_tools + kit.tools
+system_prompt = kit.prompt(state, config)
+```
+
+### Standalone `SkillKit`
+
+Use `SkillKit` directly for skill discovery without the middleware layer:
+
+```python
+from langchain_agentkit import SkillKit
+
+kit = SkillKit("skills/")
+tools = kit.tools  # [Skill, SkillRead]
+```
+
+## Examples
+
+See [`examples/`](examples/) for complete working code:
+
+- **[`standalone_node.py`](examples/standalone_node.py)** — Simplest usage: declare a node class, compile, invoke
+- **[`manual_wiring.py`](examples/manual_wiring.py)** — Use `SkillKit` as a standalone toolkit with full graph control
+- **[`multi_agent.py`](examples/multi_agent.py)** — Compose multiple agents in a parent graph
+- **[`root_with_checkpointer.py`](examples/root_with_checkpointer.py)** — Multi-turn conversations with `interrupt()` and `Command(resume=...)`
+- **[`subgraph_with_checkpointer.py`](examples/subgraph_with_checkpointer.py)** — Subgraph inherits parent's checkpointer automatically
+- **[`custom_state_type.py`](examples/custom_state_type.py)** — Custom state shape via handler annotation + subgraph schema translation
+
+## API Reference
+
+### `agent`
+
+Declarative agent builder. Subclassing produces a `StateGraph`. Call `.compile()` to get a runnable graph.
+
+**Class attributes:**
+
+| Attribute | Required | Description |
+|-----------|----------|-------------|
+| `llm` | Yes | Language model instance |
+| `tools` | No | List of LangChain tools |
+| `middleware` | No | Ordered list of `Middleware` instances |
+| `prompt` | No | System prompt — inline string, file path, or list of either |
+
+**Handler signature:**
+
+```python
+async def handler(state, *, llm, tools, prompt, config, runtime): ...
+```
+
+`state` is positional. Everything after `*` is keyword-only and injected by name — declare only what you need:
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `state` | `dict` | LangGraph state (positional, required) |
+| `llm` | `BaseChatModel` | LLM pre-bound with all tools via `bind_tools()` |
+| `tools` | `list[BaseTool]` | All tools (user tools + middleware tools) |
+| `prompt` | `str` | Fully composed prompt (template + middleware sections) |
+| `config` | `RunnableConfig` | LangGraph config for the current invocation |
+| `runtime` | `Any` | LangGraph runtime context (passed through from graph kwargs) |
+
+Both sync and async handlers are supported — sync handlers are detected via `inspect.isawaitable` and awaited automatically.
+
+**Custom state types** — annotate the handler's `state` parameter:
+
+```python
+class MyState(TypedDict, total=False):
+    messages: Annotated[list, add_messages]
+    draft: dict | None
+
+class my_agent(agent):
+    llm = ChatOpenAI(model="gpt-4o")
+
+    async def handler(state: MyState, *, llm):
+        ...
+```
+
+Without an annotation, `AgentState` is used by default.
+
+### `Middleware` protocol
+
+Any class with `tools` (property) and `prompt(state, config)` (method) satisfies the protocol via structural subtyping — no base class needed:
+
+```python
+class MyMiddleware:
+    @property
+    def tools(self) -> list[BaseTool]:
+        return [my_tool]
+
+    def prompt(self, state: dict, config: RunnableConfig) -> str | None:
+        return "You have access to my_tool."
+```
+
+**Built-in middleware:**
+
+| Middleware | Tools | Prompt |
+|-----------|-------|--------|
+| `SkillsMiddleware(skills_dirs)` | `Skill`, `SkillRead` | Progressive disclosure skill list with load instructions |
+| `TasksMiddleware()` | `TaskCreate`, `TaskUpdate`, `TaskList`, `TaskGet` | Base agent behavior + task context with status icons |
+
+### `TasksMiddleware`
+
+Task management middleware with `Command`-based tools that update graph state via LangGraph's `ToolNode`.
+
+```python
+# Default — auto-creates task tools
+mw = TasksMiddleware()
+
+# Custom tools
+mw = TasksMiddleware(task_tools=[my_create, my_update])
+
+# Custom task formatter
+mw = TasksMiddleware(formatter=my_format_function)
+```
+
+Task tools use `InjectedState` to read tasks from state and return `Command(update={"tasks": [...]})` to apply changes. Task state is updated locally within the agent's graph, visible to the prompt on every ReAct loop iteration. When used as a subgraph, state flows back to the parent graph on completion.
+
+You can also create task tools directly:
+
+```python
+from langchain_agentkit import create_task_tools
+
+tools = create_task_tools()  # [TaskCreate, TaskUpdate, TaskList, TaskGet]
+```
+
+### `AgentKit(middleware, prompt=None)`
+
+Composition engine that merges tools and prompts from middleware.
+
+- **`tools`** — All tools from all middleware, deduplicated by name (first middleware wins, cached)
+- **`prompt(state, config)`** — Template + middleware sections, joined with double newline (dynamic per call)
+
+Prompt templates can be inline strings, file paths, or a list of either:
+
+```python
+kit = AgentKit(middleware, prompt="You are helpful.")
+kit = AgentKit(middleware, prompt=Path("prompts/system.txt"))
+kit = AgentKit(middleware, prompt=["prompts/base.txt", "Extra instructions"])
+```
+
+### `node`
+
+The original skill-aware metaclass. Uses `skills` attribute instead of `middleware`. Consider migrating to `agent` for the full middleware composition model — `agent` adds `middleware`, `prompt`, and `config` injection.
+
+```python
+class my_agent(node):
+    llm = ChatOpenAI(model="gpt-4o")
+    tools = [web_search]
+    skills = "skills/"  # str, list[str], or SkillKit instance
+
+    async def handler(state, *, llm, tools, runtime): ...
+```
+
+### `AgentState`
+
+Minimal LangGraph state type with task support:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `messages` | `Annotated[list, add_messages]` | Conversation history with LangGraph message reducer |
+| `sender` | `str` | Name of the last node that produced output |
+| `tasks` | `list[dict[str, Any]]` | Task list managed by `TasksMiddleware` tools |
+
+Extend with your own fields:
+
+```python
+class MyState(AgentState):
+    current_project: str
+    iteration_count: int
+```
+
+## Security
+
+- **Path traversal prevention**: Skill file paths resolved to absolute and checked against skill directories. Reference file names reject `.` and `..` patterns.
+- **Name validation**: Skill names validated per [AgentSkills.io spec](https://agentskills.io/specification) — lowercase alphanumeric + hyphens, 1-64 chars.
+- **Tool scoping**: Each agent only has access to the tools declared in its `tools` attribute plus middleware-provided tools.
+- **Prompt trust boundary**: Prompt templates and middleware prompt sections are set by the developer at construction time, not by end-user input.
+
+## Migrating from `langchain-skillkit`
+
+`langchain-agentkit` v0.4.0 is the successor to `langchain-skillkit`. The old import path works with a deprecation warning:
+
+```python
+# Still works — emits DeprecationWarning
+from langchain_skillkit import node, SkillKit, AgentState
+
+# Update to:
+from langchain_agentkit import node, SkillKit, AgentState
+```
+
+**What changed:**
+
+| Before (`langchain-skillkit`) | After (`langchain-agentkit`) |
+|------------------------------|------------------------------|
+| `from langchain_skillkit import ...` | `from langchain_agentkit import ...` |
+| `node` with `skills` attribute | `node` (unchanged) + new `agent` with `middleware` |
+| `SkillKit` only | `SkillKit` + `SkillsMiddleware` + `TasksMiddleware` |
+| No middleware system | `Middleware` protocol + `AgentKit` composition |
+| Handler injectables: `llm`, `tools`, `runtime` | `agent` adds: `prompt`, `config` |
+
+**Migration steps:**
+
+1. Update imports from `langchain_skillkit` to `langchain_agentkit`
+2. Existing `node` subclasses work unchanged
+3. Optionally migrate `node` to `agent` for middleware support:
+   - Replace `skills = "skills/"` with `middleware = [SkillsMiddleware("skills/")]`
+   - Add `prompt` and `config` injectables as needed
+
+## Contributing
+
+```bash
+git clone https://github.com/rsmdt/langchain-agentkit.git
+cd langchain-agentkit
+uv sync --extra dev
+uv run pytest --tb=short -q
+uv run ruff check src/ tests/
+uv run mypy src/
+```

langchain_agentkit-0.4.0/README.md

@@ -0,0 +1,281 @@
+# langchain-agentkit
+
+Composable middleware framework for LangGraph agents.
+
+[![Python](https://img.shields.io/pypi/pyversions/langchain-agentkit.svg)](https://pypi.org/project/langchain-agentkit/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Build LangGraph agents with reusable middleware that composes tools and prompts. Two layers to choose from:
+
+- **`agent` metaclass** — declare a class, get a complete ReAct agent with middleware-composed tools and prompts
+- **`AgentKit`** — primitive composition engine for full control over graph topology
+
+> **Migrating from `langchain-skillkit`?** See [Migration](#migrating-from-langchain-skillkit) below. The old import path still works with a deprecation warning.
+
+## Installation
+
+Requires **Python 3.11+**, `langchain-core>=0.3`, `langgraph>=0.4`.
+
+```bash
+pip install langchain-agentkit
+```
+
+## Quick Start
+
+### The `agent` metaclass (recommended)
+
+Declare a class that inherits from `agent` to get a `StateGraph` with an automatic ReAct loop:
+
+```python
+from langchain_core.messages import HumanMessage, SystemMessage
+from langchain_openai import ChatOpenAI
+from langchain_agentkit import agent, SkillsMiddleware, TasksMiddleware
+
+class researcher(agent):
+    llm = ChatOpenAI(model="gpt-4o")
+    tools = [web_search]
+    middleware = [SkillsMiddleware("skills/"), TasksMiddleware()]
+    prompt = "You are a research assistant."
+
+    async def handler(state, *, llm, prompt):
+        messages = [SystemMessage(content=prompt)] + state["messages"]
+        response = await llm.ainvoke(messages)
+        return {"messages": [response], "sender": "researcher"}
+
+# Compile and use
+graph = researcher.compile()
+result = graph.invoke({"messages": [HumanMessage("Size the B2B SaaS market")]})
+
+# With checkpointer for interrupt() support
+from langgraph.checkpoint.memory import InMemorySaver
+graph = researcher.compile(checkpointer=InMemorySaver())
+```
+
+### `AgentKit` for manual graph wiring
+
+Use `AgentKit` when you need full control over graph topology — multi-node graphs, shared `ToolNode`, custom routing:
+
+```python
+from langchain_agentkit import AgentKit, SkillsMiddleware, TasksMiddleware
+
+kit = AgentKit([
+    SkillsMiddleware("skills/"),
+    TasksMiddleware(),
+])
+
+# In any graph node:
+all_tools = my_tools + kit.tools
+system_prompt = kit.prompt(state, config)
+```
+
+### Standalone `SkillKit`
+
+Use `SkillKit` directly for skill discovery without the middleware layer:
+
+```python
+from langchain_agentkit import SkillKit
+
+kit = SkillKit("skills/")
+tools = kit.tools  # [Skill, SkillRead]
+```
+
+## Examples
+
+See [`examples/`](examples/) for complete working code:
+
+- **[`standalone_node.py`](examples/standalone_node.py)** — Simplest usage: declare a node class, compile, invoke
+- **[`manual_wiring.py`](examples/manual_wiring.py)** — Use `SkillKit` as a standalone toolkit with full graph control
+- **[`multi_agent.py`](examples/multi_agent.py)** — Compose multiple agents in a parent graph
+- **[`root_with_checkpointer.py`](examples/root_with_checkpointer.py)** — Multi-turn conversations with `interrupt()` and `Command(resume=...)`
+- **[`subgraph_with_checkpointer.py`](examples/subgraph_with_checkpointer.py)** — Subgraph inherits parent's checkpointer automatically
+- **[`custom_state_type.py`](examples/custom_state_type.py)** — Custom state shape via handler annotation + subgraph schema translation
+
+## API Reference
+
+### `agent`
+
+Declarative agent builder. Subclassing produces a `StateGraph`. Call `.compile()` to get a runnable graph.
+
+**Class attributes:**
+
+| Attribute | Required | Description |
+|-----------|----------|-------------|
+| `llm` | Yes | Language model instance |
+| `tools` | No | List of LangChain tools |
+| `middleware` | No | Ordered list of `Middleware` instances |
+| `prompt` | No | System prompt — inline string, file path, or list of either |
+
+**Handler signature:**
+
+```python
+async def handler(state, *, llm, tools, prompt, config, runtime): ...
+```
+
+`state` is positional. Everything after `*` is keyword-only and injected by name — declare only what you need:
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `state` | `dict` | LangGraph state (positional, required) |
+| `llm` | `BaseChatModel` | LLM pre-bound with all tools via `bind_tools()` |
+| `tools` | `list[BaseTool]` | All tools (user tools + middleware tools) |
+| `prompt` | `str` | Fully composed prompt (template + middleware sections) |
+| `config` | `RunnableConfig` | LangGraph config for the current invocation |
+| `runtime` | `Any` | LangGraph runtime context (passed through from graph kwargs) |
+
+Both sync and async handlers are supported — sync handlers are detected via `inspect.isawaitable` and awaited automatically.
+
+**Custom state types** — annotate the handler's `state` parameter:
+
+```python
+class MyState(TypedDict, total=False):
+    messages: Annotated[list, add_messages]
+    draft: dict | None
+
+class my_agent(agent):
+    llm = ChatOpenAI(model="gpt-4o")
+
+    async def handler(state: MyState, *, llm):
+        ...
+```
+
+Without an annotation, `AgentState` is used by default.
+
+### `Middleware` protocol
+
+Any class with `tools` (property) and `prompt(state, config)` (method) satisfies the protocol via structural subtyping — no base class needed:
+
+```python
+class MyMiddleware:
+    @property
+    def tools(self) -> list[BaseTool]:
+        return [my_tool]
+
+    def prompt(self, state: dict, config: RunnableConfig) -> str | None:
+        return "You have access to my_tool."
+```
+
+**Built-in middleware:**
+
+| Middleware | Tools | Prompt |
+|-----------|-------|--------|
+| `SkillsMiddleware(skills_dirs)` | `Skill`, `SkillRead` | Progressive disclosure skill list with load instructions |
+| `TasksMiddleware()` | `TaskCreate`, `TaskUpdate`, `TaskList`, `TaskGet` | Base agent behavior + task context with status icons |
+
+### `TasksMiddleware`
+
+Task management middleware with `Command`-based tools that update graph state via LangGraph's `ToolNode`.
+
+```python
+# Default — auto-creates task tools
+mw = TasksMiddleware()
+
+# Custom tools
+mw = TasksMiddleware(task_tools=[my_create, my_update])
+
+# Custom task formatter
+mw = TasksMiddleware(formatter=my_format_function)
+```
+
+Task tools use `InjectedState` to read tasks from state and return `Command(update={"tasks": [...]})` to apply changes. Task state is updated locally within the agent's graph, visible to the prompt on every ReAct loop iteration. When used as a subgraph, state flows back to the parent graph on completion.
+
+You can also create task tools directly:
+
+```python
+from langchain_agentkit import create_task_tools
+
+tools = create_task_tools()  # [TaskCreate, TaskUpdate, TaskList, TaskGet]
+```
+
+### `AgentKit(middleware, prompt=None)`
+
+Composition engine that merges tools and prompts from middleware.
+
+- **`tools`** — All tools from all middleware, deduplicated by name (first middleware wins, cached)
+- **`prompt(state, config)`** — Template + middleware sections, joined with double newline (dynamic per call)
+
+Prompt templates can be inline strings, file paths, or a list of either:
+
+```python
+kit = AgentKit(middleware, prompt="You are helpful.")
+kit = AgentKit(middleware, prompt=Path("prompts/system.txt"))
+kit = AgentKit(middleware, prompt=["prompts/base.txt", "Extra instructions"])
+```
+
+### `node`
+
+The original skill-aware metaclass. Uses `skills` attribute instead of `middleware`. Consider migrating to `agent` for the full middleware composition model — `agent` adds `middleware`, `prompt`, and `config` injection.
+
+```python
+class my_agent(node):
+    llm = ChatOpenAI(model="gpt-4o")
+    tools = [web_search]
+    skills = "skills/"  # str, list[str], or SkillKit instance
+
+    async def handler(state, *, llm, tools, runtime): ...
+```
+
+### `AgentState`
+
+Minimal LangGraph state type with task support:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `messages` | `Annotated[list, add_messages]` | Conversation history with LangGraph message reducer |
+| `sender` | `str` | Name of the last node that produced output |
+| `tasks` | `list[dict[str, Any]]` | Task list managed by `TasksMiddleware` tools |
+
+Extend with your own fields:
+
+```python
+class MyState(AgentState):
+    current_project: str
+    iteration_count: int
+```
+
+## Security
+
+- **Path traversal prevention**: Skill file paths resolved to absolute and checked against skill directories. Reference file names reject `.` and `..` patterns.
+- **Name validation**: Skill names validated per [AgentSkills.io spec](https://agentskills.io/specification) — lowercase alphanumeric + hyphens, 1-64 chars.
+- **Tool scoping**: Each agent only has access to the tools declared in its `tools` attribute plus middleware-provided tools.
+- **Prompt trust boundary**: Prompt templates and middleware prompt sections are set by the developer at construction time, not by end-user input.
+
+## Migrating from `langchain-skillkit`
+
+`langchain-agentkit` v0.4.0 is the successor to `langchain-skillkit`. The old import path works with a deprecation warning:
+
+```python
+# Still works — emits DeprecationWarning
+from langchain_skillkit import node, SkillKit, AgentState
+
+# Update to:
+from langchain_agentkit import node, SkillKit, AgentState
+```
+
+**What changed:**
+
+| Before (`langchain-skillkit`) | After (`langchain-agentkit`) |
+|------------------------------|------------------------------|
+| `from langchain_skillkit import ...` | `from langchain_agentkit import ...` |
+| `node` with `skills` attribute | `node` (unchanged) + new `agent` with `middleware` |
+| `SkillKit` only | `SkillKit` + `SkillsMiddleware` + `TasksMiddleware` |
+| No middleware system | `Middleware` protocol + `AgentKit` composition |
+| Handler injectables: `llm`, `tools`, `runtime` | `agent` adds: `prompt`, `config` |
+
+**Migration steps:**
+
+1. Update imports from `langchain_skillkit` to `langchain_agentkit`
+2. Existing `node` subclasses work unchanged
+3. Optionally migrate `node` to `agent` for middleware support:
+   - Replace `skills = "skills/"` with `middleware = [SkillsMiddleware("skills/")]`
+   - Add `prompt` and `config` injectables as needed
+
+## Contributing
+
+```bash
+git clone https://github.com/rsmdt/langchain-agentkit.git
+cd langchain-agentkit
+uv sync --extra dev
+uv run pytest --tb=short -q
+uv run ruff check src/ tests/
+uv run mypy src/
+```