dreadnode 1.16.0__tar.gz → 1.17.1__tar.gz

{dreadnode-1.16.0 → dreadnode-1.17.1}/.gitignore

@@ -156,6 +156,7 @@ venv.bak/
 
 # mkdocs documentation
 /site
+debug.html
 
 # mypy
 .mypy_cache/

{dreadnode-1.16.0 → dreadnode-1.17.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dreadnode
-Version: 1.16.0
+Version: 1.17.1
 Summary: Dreadnode SDK
 Project-URL: Homepage, https://github.com/dreadnode/sdk
 Project-URL: Repository, https://github.com/dreadnode/sdk
@@ -208,14 +208,22 @@ License:                                  Apache License
         See the License for the specific language governing permissions and
         limitations under the License.
 License-File: LICENSE
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Requires-Python: <3.14,>=3.10
+Requires-Dist: aiofiles<25.0.0,>=24.1.0
 Requires-Dist: coolname<3.0.0,>=2.2.0
 Requires-Dist: cyclopts>=4.2.0
-Requires-Dist: fsspec[s3]<=2025.3.0,>=2023.1.0
+Requires-Dist: fsspec[s3]<=2025.12.0,>=2023.1.0
 Requires-Dist: httpx<1.0.0,>=0.28.0
 Requires-Dist: logfire<=3.20.0,>=3.5.3
 Requires-Dist: loguru>=0.7.3
-Requires-Dist: numpy<=2.2.6
+Requires-Dist: numpy<=2.3.5
 Requires-Dist: optuna<5.0.0,>=4.5.0
 Requires-Dist: pandas<3.0.0,>=2.2.3
 Requires-Dist: pydantic<3.0.0,>=2.9.2
@@ -278,7 +286,7 @@ Dreadnode Strikes SDK
     <img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/dreadnode">
     <img alt="PyPI - Version" src="https://img.shields.io/pypi/v/dreadnode">
     <img alt="GitHub License" src="https://img.shields.io/github/license/dreadnode/sdk">
-    <img alt="Tests" src="https://img.shields.io/github/actions/workflow/status/dreadnode/sdk/tests.yaml">
+    <img alt="Tests" src="https://img.shields.io/github/actions/workflow/status/dreadnode/sdk/test.yaml">
     <img alt="Pre-Commit" src="https://img.shields.io/github/actions/workflow/status/dreadnode/sdk/pre-commit.yaml">
     <img alt="Renovate" src="https://img.shields.io/github/actions/workflow/status/dreadnode/sdk/renovate.yaml">
 </h4>

{dreadnode-1.16.0 → dreadnode-1.17.1}/README.md

@@ -16,7 +16,7 @@ Dreadnode Strikes SDK
     <img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/dreadnode">
     <img alt="PyPI - Version" src="https://img.shields.io/pypi/v/dreadnode">
     <img alt="GitHub License" src="https://img.shields.io/github/license/dreadnode/sdk">
-    <img alt="Tests" src="https://img.shields.io/github/actions/workflow/status/dreadnode/sdk/tests.yaml">
+    <img alt="Tests" src="https://img.shields.io/github/actions/workflow/status/dreadnode/sdk/test.yaml">
     <img alt="Pre-Commit" src="https://img.shields.io/github/actions/workflow/status/dreadnode/sdk/pre-commit.yaml">
     <img alt="Renovate" src="https://img.shields.io/github/actions/workflow/status/dreadnode/sdk/renovate.yaml">
 </h4>

{dreadnode-1.16.0 → dreadnode-1.17.1}/dreadnode/__init__.py

@@ -38,7 +38,7 @@ from dreadnode.version import VERSION
 if t.TYPE_CHECKING:
     from dreadnode import agent, airt, eval, optimization, scorers, transforms  # noqa: A004
     from dreadnode.agent import Agent, tool, tool_method
-    from dreadnode.data_types import Audio, Image, Table, Video
+    from dreadnode.data_types import Audio, Image, Message, Table, Video
 
 logger.disable("dreadnode")
 
@@ -88,6 +88,7 @@ __all__ = [
     "EnvVar",
     "Image",
     "Markdown",
+    "Message",
     "Metric",
     "MetricDict",
     "Object",
@@ -151,6 +152,7 @@ __lazy_components__: dict[str, str] = {
     "Image": "dreadnode.data_types",
     "Table": "dreadnode.data_types",
     "Video": "dreadnode.data_types",
+    "Message": "dreadnode.data_types",
     "Agent": "dreadnode.agent",
     "tool": "dreadnode.agent",
     "tool_method": "dreadnode.agent",

{dreadnode-1.16.0 → dreadnode-1.17.1}/dreadnode/agent/agent.py

@@ -2,7 +2,7 @@ import inspect
 import json
 import re
 import typing as t
-from contextlib import aclosing, asynccontextmanager
+from contextlib import AsyncExitStack, aclosing, asynccontextmanager
 from copy import deepcopy
 from textwrap import dedent
 
@@ -875,8 +875,16 @@ class Agent(Model):
         commit: CommitBehavior = "always",
     ) -> t.AsyncIterator[t.AsyncGenerator[AgentEvent, None]]:
         thread = thread or self.thread
-        async with aclosing(self._stream_traced(thread, user_input, commit=commit)) as stream:
-            yield stream
+
+        async with AsyncExitStack() as stack:
+            # Ensure all tools are properly entered if they
+            # are context managers before we start using them
+            for tool_container in self.tools:
+                if hasattr(tool_container, "__aenter__") and hasattr(tool_container, "__aexit__"):
+                    await stack.enter_async_context(tool_container)
+
+            async with aclosing(self._stream_traced(thread, user_input, commit=commit)) as stream:
+                yield stream
 
     async def run(
         self,

{dreadnode-1.16.0 → dreadnode-1.17.1}/dreadnode/agent/hooks/summarize.py

@@ -49,6 +49,7 @@ def summarize_when_long(
     model: str | rg.Generator | None = None,
     max_tokens: int = 100_000,
     min_messages_to_keep: int = 5,
+    guidance: str = "",
 ) -> "Hook":
     """
     Creates a hook to manage the agent's context window by summarizing the conversation history.
@@ -64,6 +65,7 @@ def summarize_when_long(
         max_tokens: The maximum number of tokens allowed in the context window before summarization is triggered
             (default is None, meaning no proactive summarization).
         min_messages_to_keep: The minimum number of messages to retain after summarization (default is 5).
+        guidance: Additional guidance for the summarization process (default is "").
     """
 
     if min_messages_to_keep < 2:
@@ -85,6 +87,10 @@ def summarize_when_long(
         min_messages_to_keep: int = Config(
             5, help="Minimum number of messages to retain after summarization"
         ),
+        guidance: str = Config(
+            guidance,
+            help="Additional guidance for the summarization process",
+        ),
     ) -> Reaction | None:
         should_summarize = False
 
@@ -149,7 +155,7 @@ def summarize_when_long(
 
         # Generate the summary and rebuild the messages
         summary = await summarize_conversation.bind(summarizer_model)(
-            "\n".join(str(msg) for msg in messages_to_summarize)
+            "\n".join(str(msg) for msg in messages_to_summarize), guidance=guidance
         )
         summary_content = (
             f"<conversation-summary messages={len(messages_to_summarize)}>\n"

{dreadnode-1.16.0 → dreadnode-1.17.1}/dreadnode/agent/tools/base.py

@@ -1,6 +1,8 @@
+import asyncio
+import functools
 import typing as t
 
-from pydantic import ConfigDict
+from pydantic import ConfigDict, PrivateAttr
 from rigging import tools
 from rigging.tools.base import ToolMethod as RiggingToolMethod
 
@@ -171,18 +173,82 @@ class Toolset(Model):
     - Pydantic's declarative syntax for defining state (fields).
     - Automatic application of the `@configurable` decorator.
     - A `get_tools` method for discovering methods decorated with `@dreadnode.tool_method`.
+    - Support for async context management, with automatic re-entrancy handling.
     """
 
+    model_config = ConfigDict(arbitrary_types_allowed=True, use_attribute_docstrings=True)
+
     variant: str | None = None
     """The variant for filtering tools available in this toolset."""
 
-    model_config = ConfigDict(arbitrary_types_allowed=True, use_attribute_docstrings=True)
+    # Context manager magic
+    _entry_ref_count: int = PrivateAttr(default=0)
+    _context_handle: object = PrivateAttr(default=None)
+    _entry_lock: asyncio.Lock = PrivateAttr(default_factory=asyncio.Lock)
 
     @property
     def name(self) -> str:
         """The name of the toolset, derived from the class name."""
         return self.__class__.__name__
 
+    def __init_subclass__(cls, **kwargs: t.Any) -> None:
+        super().__init_subclass__(**kwargs)
+
+        # This essentially ensures that if the Toolset is any kind of context manager,
+        # it will be re-entrant, and only actually enter/exit once. This means we can
+        # safely build auto-entry/exit logic into our Agent class without worrying about
+        # breaking the code if the user happens to enter a toolset manually before using
+        # it in an agent.
+
+        original_aenter = cls.__dict__.get("__aenter__")
+        original_enter = cls.__dict__.get("__enter__")
+        original_aexit = cls.__dict__.get("__aexit__")
+        original_exit = cls.__dict__.get("__exit__")
+
+        has_enter = callable(original_aenter) or callable(original_enter)
+        has_exit = callable(original_aexit) or callable(original_exit)
+
+        if has_enter and not has_exit:
+            raise TypeError(
+                f"{cls.__name__} defining __aenter__ or __enter__ must also define __aexit__ or __exit__"
+            )
+        if has_exit and not has_enter:
+            raise TypeError(
+                f"{cls.__name__} defining __aexit__ or __exit__ must also define __aenter__ or __enter__"
+            )
+        if original_aenter and original_enter:
+            raise TypeError(f"{cls.__name__} cannot define both __aenter__ and __enter__")
+        if original_aexit and original_exit:
+            raise TypeError(f"{cls.__name__} cannot define both __aexit__ and __exit__")
+
+        @functools.wraps(original_aenter or original_enter)  # type: ignore[arg-type]
+        async def aenter_wrapper(self: "Toolset", *args: t.Any, **kwargs: t.Any) -> t.Any:
+            async with self._entry_lock:
+                if self._entry_ref_count == 0:
+                    handle = None
+                    if original_aenter:
+                        handle = await original_aenter(self, *args, **kwargs)
+                    elif original_enter:
+                        handle = original_enter(self, *args, **kwargs)
+                    self._context_handle = handle if handle is not None else self
+                self._entry_ref_count += 1
+                return self._context_handle
+
+        cls.__aenter__ = aenter_wrapper  # type: ignore[attr-defined]
+
+        @functools.wraps(original_aexit or original_exit)  # type: ignore[arg-type]
+        async def aexit_wrapper(self: "Toolset", *args: t.Any, **kwargs: t.Any) -> t.Any:
+            async with self._entry_lock:
+                self._entry_ref_count -= 1
+                if self._entry_ref_count == 0:
+                    if original_aexit:
+                        await original_aexit(self, *args, **kwargs)
+                    elif original_exit:
+                        original_exit(self, *args, **kwargs)
+                    self._context_handle = None
+
+        cls.__aexit__ = aexit_wrapper  # type: ignore[attr-defined]
+
     def get_tools(self, *, variant: str | None = None) -> list[AnyTool]:
         variant = variant or self.variant