deepagents 0.0.11rc1__tar.gz → 0.0.12rc2__tar.gz

{deepagents-0.0.11rc1 → deepagents-0.0.12rc2}/PKG-INFO

@@ -1,21 +1,22 @@
 Metadata-Version: 2.4
 Name: deepagents
-Version: 0.0.11rc1
+Version: 0.0.12rc2
 Summary: General purpose 'deep agent' with sub-agent spawning, todo list capabilities, and mock file system. Built on LangGraph.
 License: MIT
 Requires-Python: <4.0,>=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: langgraph>=1.0.0a3
-Requires-Dist: langchain-anthropic>=0.1.23
-Requires-Dist: langchain>=1.0.0a10
+Requires-Dist: langgraph>=1.0.0a4
+Requires-Dist: langchain-anthropic>=1.0.0a4
+Requires-Dist: langchain>=1.0.0a15
 Requires-Dist: langgraph-prebuilt>=0.7.0a2
-Requires-Dist: ai-filesystem>=0.1.4
+Requires-Dist: langchain-core>=1.0.0a6
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
+Requires-Dist: langchain-openai; extra == "dev"
 Dynamic: license-file
 
 # 🧠🤖Deep Agents
@@ -77,8 +78,8 @@ Use this to run an internet search for a given query. You can specify the number
 
 # Create the agent
 agent = create_deep_agent(
-    [internet_search],
-    research_instructions,
+    tools=[internet_search],
+    system_prompt=research_instructions,
 )
 
 # Invoke the agent
@@ -226,7 +227,7 @@ critique_sub_agent = {
     "description": "Critique the final report",
     "prompt": "You are a tough editor.",
     "model_settings": {
-        "model": "anthropic:claude-3-5-haiku-20241022",
+        "model": "claude-sonnet-4-202505142",
         "temperature": 0,
         "max_tokens": 8192
     }
@@ -244,10 +245,10 @@ agent = create_deep_agent(
 ### `middleware` (Optional)
 Both the main agent and sub-agents can take additional custom AgentMiddleware. Middleware is the best supported approach for extending the state_schema, adding additional tools, and adding pre / post model hooks. See this [doc](https://docs.langchain.com/oss/python/langchain/middleware) to learn more about Middleware and how you can use it!
 
-### `tool_configs` (Optional)
+### `interrupt_on` (Optional)
 Tool configs are used to specify how to handle Human In The Loop interactions on certain tools that require additional human oversight. 
 
-These tool_configs are passed to our prebuilt [HITL middleware](https://docs.langchain.com/oss/python/langchain/middleware#human-in-the-loop) so that the agent pauses execution and waits for feedback from the user before executing configured tools.
+These tool configs are passed to our prebuilt [HITL middleware](https://docs.langchain.com/oss/python/langchain/middleware#human-in-the-loop) so that the agent pauses execution and waits for feedback from the user before executing configured tools.
 
 ## Deep Agent Details
 
@@ -314,7 +315,7 @@ If you want to omit some deepagents functionality, use specific middleware compo
 
 ### Human-in-the-Loop
 
-`deepagents` supports human-in-the-loop approval for tool execution. You can configure specific tools to require human approval before execution using the `tool_configs` parameter, which maps tool names to a `HumanInTheLoopConfig`.
+`deepagents` supports human-in-the-loop approval for tool execution. You can configure specific tools to require human approval before execution using the `interrupt_on` parameter, which maps tool names to a `HumanInTheLoopConfig`.
 
 `HumanInTheLoopConfig` is how you specify what type of human in the loop patterns are supported. 
 It is a dictionary with four specific keys:
@@ -338,7 +339,7 @@ from langgraph.checkpoint.memory import InMemorySaver
 agent = create_deep_agent(
     tools=[your_tools],
     instructions="Your instructions here",
-    tool_configs={
+    interrupt_on={
         # You can specify a dictionary for fine grained control over what interrupt options exist
         "tool_1": {
             "allow_respond": True,

{deepagents-0.0.11rc1 → deepagents-0.0.12rc2}/README.md

@@ -57,8 +57,8 @@ Use this to run an internet search for a given query. You can specify the number
 
 # Create the agent
 agent = create_deep_agent(
-    [internet_search],
-    research_instructions,
+    tools=[internet_search],
+    system_prompt=research_instructions,
 )
 
 # Invoke the agent
@@ -206,7 +206,7 @@ critique_sub_agent = {
     "description": "Critique the final report",
     "prompt": "You are a tough editor.",
     "model_settings": {
-        "model": "anthropic:claude-3-5-haiku-20241022",
+        "model": "claude-sonnet-4-202505142",
         "temperature": 0,
         "max_tokens": 8192
     }
@@ -224,10 +224,10 @@ agent = create_deep_agent(
 ### `middleware` (Optional)
 Both the main agent and sub-agents can take additional custom AgentMiddleware. Middleware is the best supported approach for extending the state_schema, adding additional tools, and adding pre / post model hooks. See this [doc](https://docs.langchain.com/oss/python/langchain/middleware) to learn more about Middleware and how you can use it!
 
-### `tool_configs` (Optional)
+### `interrupt_on` (Optional)
 Tool configs are used to specify how to handle Human In The Loop interactions on certain tools that require additional human oversight. 
 
-These tool_configs are passed to our prebuilt [HITL middleware](https://docs.langchain.com/oss/python/langchain/middleware#human-in-the-loop) so that the agent pauses execution and waits for feedback from the user before executing configured tools.
+These tool configs are passed to our prebuilt [HITL middleware](https://docs.langchain.com/oss/python/langchain/middleware#human-in-the-loop) so that the agent pauses execution and waits for feedback from the user before executing configured tools.
 
 ## Deep Agent Details
 
@@ -294,7 +294,7 @@ If you want to omit some deepagents functionality, use specific middleware compo
 
 ### Human-in-the-Loop
 
-`deepagents` supports human-in-the-loop approval for tool execution. You can configure specific tools to require human approval before execution using the `tool_configs` parameter, which maps tool names to a `HumanInTheLoopConfig`.
+`deepagents` supports human-in-the-loop approval for tool execution. You can configure specific tools to require human approval before execution using the `interrupt_on` parameter, which maps tool names to a `HumanInTheLoopConfig`.
 
 `HumanInTheLoopConfig` is how you specify what type of human in the loop patterns are supported. 
 It is a dictionary with four specific keys:
@@ -318,7 +318,7 @@ from langgraph.checkpoint.memory import InMemorySaver
 agent = create_deep_agent(
     tools=[your_tools],
     instructions="Your instructions here",
-    tool_configs={
+    interrupt_on={
         # You can specify a dictionary for fine grained control over what interrupt options exist
         "tool_1": {
             "allow_respond": True,

deepagents-0.0.12rc2/pyproject.toml

@@ -0,0 +1,96 @@
+[project]
+name = "deepagents"
+version = "0.0.12rc2"
+description = "General purpose 'deep agent' with sub-agent spawning, todo list capabilities, and mock file system. Built on LangGraph."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11,<4.0"
+dependencies = [
+    "langgraph>=1.0.0a4",
+    "langchain-anthropic>=1.0.0a4",
+    "langchain>=1.0.0a15",
+    "langgraph-prebuilt>=0.7.0a2",
+    "langchain-core>=1.0.0a6"
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "pytest-cov",
+    "build",
+    "twine",
+    "langchain-openai"
+]
+
+[dependency-groups]
+lint = [
+    "ruff>=0.12.2,<0.13.0",
+]
+typing = [
+    "mypy>=1.18.1,<1.19.0",
+]
+
+[build-system]
+requires = ["setuptools>=73.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["deepagents*"]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.setuptools.package-data]
+"*" = ["py.typed"]
+
+[tool.ruff]
+line-length = 150
+# Exclude any files that shouldn't be linted
+exclude = []
+
+[tool.ruff.format]
+docstring-code-format = true  # Formats code blocks in docstrings
+
+[tool.ruff.lint]
+select = [
+    "ALL"  # Enable all rules by default
+]
+ignore = [
+    "COM812",  # Messes with the formatter
+    "ISC001",  # Messes with the formatter
+    "PERF203", # Rarely useful
+    "SLF001",  # Private member access
+    "PLC0415", # Imports should be at the top. Not always desirable
+    "PLR0913", # Too many arguments in function definition
+    "PLC0414", # Inconsistent with how type checkers expect to be notified of intentional re-exports
+    "C901",    # Too complex
+]
+unfixable = ["B028"]  # Rules that shouldn't be auto-fixed
+
+[tool.ruff.lint.pyupgrade]
+keep-runtime-typing = true
+
+[tool.ruff.lint.flake8-annotations]
+allow-star-arg-any = true
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"  # Google-style docstrings
+ignore-var-parameters = true
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = [
+    "D1",      # Skip documentation rules in tests
+    "S101",    # Allow asserts in tests
+    "S311",    # Allow pseudo-random generators in tests
+    # Add more test-specific ignores
+]
+
+[tool.mypy]
+strict = true
+ignore_missing_imports = true
+enable_error_code = ["deprecated"]
+# Optional: reduce strictness if needed
+disallow_any_generics = false
+warn_return_any = false

deepagents-0.0.12rc2/src/deepagents/__init__.py

@@ -0,0 +1,7 @@
+"""DeepAgents package."""
+
+from deepagents.graph import create_deep_agent
+from deepagents.middleware.filesystem import FilesystemMiddleware
+from deepagents.middleware.subagents import CompiledSubAgent, SubAgent, SubAgentMiddleware
+
+__all__ = ["CompiledSubAgent", "FilesystemMiddleware", "SubAgent", "SubAgentMiddleware", "create_deep_agent"]

deepagents-0.0.12rc2/src/deepagents/graph.py

@@ -0,0 +1,140 @@
+"""Deepagents come with planning, filesystem, and subagents."""
+
+from collections.abc import Callable, Sequence
+from typing import Any
+
+from langchain.agents import create_agent
+from langchain.agents.middleware import HumanInTheLoopMiddleware, InterruptOnConfig, TodoListMiddleware
+from langchain.agents.middleware.summarization import SummarizationMiddleware
+from langchain.agents.middleware.types import AgentMiddleware
+from langchain.agents.structured_output import ResponseFormat
+from langchain_anthropic import ChatAnthropic
+from langchain_core.language_models import BaseChatModel
+from langchain_core.tools import BaseTool
+from langgraph.cache.base import BaseCache
+from langgraph.graph.state import CompiledStateGraph
+from langgraph.store.base import BaseStore
+from langgraph.types import Checkpointer
+
+from deepagents.middleware.filesystem import FilesystemMiddleware
+from deepagents.middleware.subagents import CompiledSubAgent, SubAgent, SubAgentMiddleware
+
+BASE_AGENT_PROMPT = "In order to complete the objective that the user asks of you, you have access to a number of standard tools."
+
+
+def get_default_model() -> ChatAnthropic:
+    """Get the default model for deep agents.
+
+    Returns:
+        ChatAnthropic instance configured with Claude Sonnet 4.
+    """
+    return ChatAnthropic(
+        model_name="claude-sonnet-4-20250514",
+        max_tokens=64000,
+    )
+
+
+def create_deep_agent(
+    model: str | BaseChatModel | None = None,
+    tools: Sequence[BaseTool | Callable | dict[str, Any]] | None = None,
+    *,
+    system_prompt: str | None = None,
+    middleware: Sequence[AgentMiddleware] = (),
+    subagents: list[SubAgent | CompiledSubAgent] | None = None,
+    response_format: ResponseFormat | None = None,
+    context_schema: type[Any] | None = None,
+    checkpointer: Checkpointer | None = None,
+    store: BaseStore | None = None,
+    use_longterm_memory: bool = False,
+    interrupt_on: dict[str, bool | InterruptOnConfig] | None = None,
+    debug: bool = False,
+    name: str | None = None,
+    cache: BaseCache | None = None,
+) -> CompiledStateGraph:
+    """Create a deep agent.
+
+    This agent will by default have access to a tool to write todos (write_todos),
+    four file editing tools: write_file, ls, read_file, edit_file, and a tool to call
+    subagents.
+
+    Args:
+        tools: The tools the agent should have access to.
+        system_prompt: The additional instructions the agent should have. Will go in
+            the system prompt.
+        middleware: Additional middleware to apply after standard middleware.
+        model: The model to use.
+        subagents: The subagents to use. Each subagent should be a dictionary with the
+            following keys:
+                - `name`
+                - `description` (used by the main agent to decide whether to call the
+                  sub agent)
+                - `prompt` (used as the system prompt in the subagent)
+                - (optional) `tools`
+                - (optional) `model` (either a LanguageModelLike instance or dict
+                  settings)
+                - (optional) `middleware` (list of AgentMiddleware)
+        response_format: A structured output response format to use for the agent.
+        context_schema: The schema of the deep agent.
+        checkpointer: Optional checkpointer for persisting agent state between runs.
+        store: Optional store for persisting longterm memories.
+        use_longterm_memory: Whether to use longterm memory - you must provide a store
+            in order to use longterm memory.
+        interrupt_on: Optional Dict[str, bool | InterruptOnConfig] mapping tool names to
+            interrupt configs.
+        debug: Whether to enable debug mode. Passed through to create_agent.
+        name: The name of the agent. Passed through to create_agent.
+        cache: The cache to use for the agent. Passed through to create_agent.
+
+    Returns:
+        A configured deep agent.
+    """
+    if model is None:
+        model = get_default_model()
+
+    deepagent_middleware = [
+        TodoListMiddleware(),
+        FilesystemMiddleware(
+            long_term_memory=use_longterm_memory,
+        ),
+        SubAgentMiddleware(
+            default_model=model,
+            default_tools=tools,
+            subagents=subagents if subagents is not None else [],
+            default_middleware=[
+                TodoListMiddleware(),
+                FilesystemMiddleware(
+                    long_term_memory=use_longterm_memory,
+                ),
+                SummarizationMiddleware(
+                    model=model,
+                    max_tokens_before_summary=120000,
+                    messages_to_keep=20,
+                ),
+            ],
+            default_interrupt_on=interrupt_on,
+            general_purpose_agent=True,
+        ),
+        SummarizationMiddleware(
+            model=model,
+            max_tokens_before_summary=120000,
+            messages_to_keep=20,
+        ),
+    ]
+    if interrupt_on is not None:
+        deepagent_middleware.append(HumanInTheLoopMiddleware(interrupt_on=interrupt_on))
+    if middleware is not None:
+        deepagent_middleware.extend(middleware)
+
+    return create_agent(
+        model,
+        system_prompt=system_prompt + "\n\n" + BASE_AGENT_PROMPT if system_prompt else BASE_AGENT_PROMPT,
+        tools=tools,
+        middleware=deepagent_middleware,
+        response_format=response_format,
+        context_schema=context_schema,
+        checkpointer=checkpointer,
+        store=store,
+        debug=debug,
+        name=name,
+        cache=cache,
+    )

deepagents-0.0.12rc2/src/deepagents/middleware/__init__.py

@@ -0,0 +1,6 @@
+"""Middleware for the DeepAgent."""
+
+from deepagents.middleware.filesystem import FilesystemMiddleware
+from deepagents.middleware.subagents import CompiledSubAgent, SubAgent, SubAgentMiddleware
+
+__all__ = ["CompiledSubAgent", "FilesystemMiddleware", "SubAgent", "SubAgentMiddleware"]