stirrup 0.1.2__tar.gz → 0.1.4__tar.gz

{stirrup-0.1.2 → stirrup-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: stirrup
-Version: 0.1.2
+Version: 0.1.4
 Summary: The lightweight foundation for building agents
 Keywords: ai,agent,llm,openai,anthropic,tools,framework
 Author: Artificial Analysis, Inc.
@@ -47,17 +47,19 @@ Requires-Dist: pydantic>=2.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: tenacity>=5.0.0
 Requires-Dist: trafilatura>=1.9.0
-Requires-Dist: stirrup[litellm,e2b,docker,mcp] ; extra == 'all'
+Requires-Dist: stirrup[litellm,e2b,docker,mcp,browser] ; extra == 'all'
+Requires-Dist: browser-use>=0.11.3 ; extra == 'browser'
 Requires-Dist: docker>=7.0.0 ; extra == 'docker'
 Requires-Dist: python-dotenv>=1.0.0 ; extra == 'docker'
 Requires-Dist: e2b-code-interpreter>=2.3.0 ; extra == 'e2b'
 Requires-Dist: litellm>=1.79.3 ; extra == 'litellm'
 Requires-Dist: mcp>=1.9.0 ; extra == 'mcp'
 Requires-Python: >=3.12
-Project-URL: Documentation, https://stirrup.artificialanalysis.ai
 Project-URL: Homepage, https://github.com/ArtificialAnalysis/Stirrup
+Project-URL: Documentation, https://stirrup.artificialanalysis.ai
 Project-URL: Repository, https://github.com/ArtificialAnalysis/Stirrup
 Provides-Extra: all
+Provides-Extra: browser
 Provides-Extra: docker
 Provides-Extra: e2b
 Provides-Extra: litellm
@@ -91,16 +93,16 @@ Stirrup is a lightweight framework, or starting point template, for building age
 
 ## Features
 
-- **Essential tools built-in:**
-  - Online search / web browsing
-  - Code execution (local, Docker container, E2B sandbox)
-  - MCP client
-  - Document input and output
-- **Skills system:** Extend agent capabilities with modular, domain-specific instruction packages
-- **Flexible tool execution:** A generic `Tool` class allows easy tool definition and extension
-- **Context management:** Automatically summarizes conversation history when approaching context limits
-- **Flexible provider support:** Pre-built support for OpenAI-compatible APIs and LiteLLM, or bring your own client
-- **Multimodal support:** Process images, video, and audio with automatic format conversion
+- 🧪 **Code execution:** Run code locally, in Docker, or in an E2B sandbox
+- 🔎 **Online search / web browsing:** Search and fetch web pages
+- 🔌 **MCP client support:** Connect to MCP servers and use their tools/resources
+- 📄 **Document input and output:** Import files into context and produce file outputs
+- 🧩 **Skills system:** Extend agents with modular, domain-specific instruction packages
+- 🛠️ **Flexible tool execution:** A generic `Tool` interface allows easy tool definition
+- 👤 **Human-in-the-loop:** Includes a built-in user input tool that enables human feedback or clarification during agent execution
+- 🧠 **Context management:** Automatically summarizes conversation history when approaching context limits
+- 🔁 **Flexible provider support:** Pre-built support for OpenAI-compatible APIs, LiteLLM, or bring your own client
+- 🖼️ **Multimodal support:** Process images, video, and audio with automatic format conversion
 
 ## Installation
 
@@ -116,6 +118,7 @@ pip install 'stirrup[litellm]'  # or: uv add 'stirrup[litellm]'
 pip install 'stirrup[docker]'   # or: uv add 'stirrup[docker]'
 pip install 'stirrup[e2b]'      # or: uv add 'stirrup[e2b]'
 pip install 'stirrup[mcp]'      # or: uv add 'stirrup[mcp]'
+pip install 'stirrup[browser]'  # or: uv add 'stirrup[browser]'
 ```
 
 ## Quick Start

{stirrup-0.1.2 → stirrup-0.1.4}/README.md

@@ -25,16 +25,16 @@ Stirrup is a lightweight framework, or starting point template, for building age
 
 ## Features
 
-- **Essential tools built-in:**
-  - Online search / web browsing
-  - Code execution (local, Docker container, E2B sandbox)
-  - MCP client
-  - Document input and output
-- **Skills system:** Extend agent capabilities with modular, domain-specific instruction packages
-- **Flexible tool execution:** A generic `Tool` class allows easy tool definition and extension
-- **Context management:** Automatically summarizes conversation history when approaching context limits
-- **Flexible provider support:** Pre-built support for OpenAI-compatible APIs and LiteLLM, or bring your own client
-- **Multimodal support:** Process images, video, and audio with automatic format conversion
+- 🧪 **Code execution:** Run code locally, in Docker, or in an E2B sandbox
+- 🔎 **Online search / web browsing:** Search and fetch web pages
+- 🔌 **MCP client support:** Connect to MCP servers and use their tools/resources
+- 📄 **Document input and output:** Import files into context and produce file outputs
+- 🧩 **Skills system:** Extend agents with modular, domain-specific instruction packages
+- 🛠️ **Flexible tool execution:** A generic `Tool` interface allows easy tool definition
+- 👤 **Human-in-the-loop:** Includes a built-in user input tool that enables human feedback or clarification during agent execution
+- 🧠 **Context management:** Automatically summarizes conversation history when approaching context limits
+- 🔁 **Flexible provider support:** Pre-built support for OpenAI-compatible APIs, LiteLLM, or bring your own client
+- 🖼️ **Multimodal support:** Process images, video, and audio with automatic format conversion
 
 ## Installation
 
@@ -50,6 +50,7 @@ pip install 'stirrup[litellm]'  # or: uv add 'stirrup[litellm]'
 pip install 'stirrup[docker]'   # or: uv add 'stirrup[docker]'
 pip install 'stirrup[e2b]'      # or: uv add 'stirrup[e2b]'
 pip install 'stirrup[mcp]'      # or: uv add 'stirrup[mcp]'
+pip install 'stirrup[browser]'  # or: uv add 'stirrup[browser]'
 ```
 
 ## Quick Start

{stirrup-0.1.2 → stirrup-0.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stirrup"
-version = "0.1.2"
+version = "0.1.4"
 description = "The lightweight foundation for building agents"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -41,7 +41,8 @@ litellm = ["litellm>=1.79.3"]
 e2b = ["e2b-code-interpreter>=2.3.0"]
 docker = ["docker>=7.0.0", "python-dotenv>=1.0.0"]
 mcp = ["mcp>=1.9.0"]
-all = ["stirrup[litellm,e2b,docker,mcp]"]
+browser = ["browser-use>=0.11.3"]
+all = ["stirrup[litellm,e2b,docker,mcp,browser]"]
 
 [project.urls]
 Homepage = "https://github.com/ArtificialAnalysis/Stirrup"
@@ -70,6 +71,7 @@ anyio_mode = "auto"
 markers = [
     "docker: marks tests as requiring the docker package (deselect with '-m \"not docker\"')",
     "e2b: marks tests as requiring the e2b package (deselect with '-m \"not e2b\"')",
+    "browser: marks tests as requiring headless Chrome (deselect with '-m \"not browser\"')",
 ]
 
 [tool.ruff]

{stirrup-0.1.2 → stirrup-0.1.4}/src/stirrup/__init__.py

@@ -35,6 +35,7 @@ from stirrup.core.models import (
     AssistantMessage,
     AudioContentBlock,
     ChatMessage,
+    EmptyParams,
     ImageContentBlock,
     LLMClient,
     SubAgentMetadata,
@@ -58,6 +59,7 @@ __all__ = [
     "AudioContentBlock",
     "ChatMessage",
     "ContextOverflowError",
+    "EmptyParams",
     "ImageContentBlock",
     "LLMClient",
     "SubAgentMetadata",

{stirrup-0.1.2 → stirrup-0.1.4}/src/stirrup/clients/__init__.py

@@ -3,12 +3,17 @@
 The default client is ChatCompletionsClient, which uses the OpenAI SDK directly
 and supports any OpenAI-compatible API via the `base_url` parameter.
 
+OpenResponsesClient uses the OpenAI Responses API (responses.create) for providers
+that support this newer API format.
+
 For multi-provider support via LiteLLM, install the litellm extra:
     pip install stirrup[litellm]
 """
 
 from stirrup.clients.chat_completions_client import ChatCompletionsClient
+from stirrup.clients.open_responses_client import OpenResponsesClient
 
 __all__ = [
     "ChatCompletionsClient",
+    "OpenResponsesClient",
 ]

{stirrup-0.1.2 → stirrup-0.1.4}/src/stirrup/clients/chat_completions_client.py

@@ -67,7 +67,6 @@ class ChatCompletionsClient(LLMClient):
         *,
         base_url: str | None = None,
         api_key: str | None = None,
-        supports_audio_input: bool = False,
         reasoning_effort: str | None = None,
         timeout: float | None = None,
         max_retries: int = 2,
@@ -82,7 +81,6 @@ class ChatCompletionsClient(LLMClient):
                 Use for OpenAI-compatible providers (e.g., 'http://localhost:8000/v1').
             api_key: API key for authentication. If None, reads from OPENROUTER_API_KEY
                 environment variable.
-            supports_audio_input: Whether the model supports audio inputs. Defaults to False.
             reasoning_effort: Reasoning effort level for extended thinking models
                 (e.g., 'low', 'medium', 'high'). Only used with o1/o3 style models.
             timeout: Request timeout in seconds. If None, uses OpenAI SDK default.
@@ -92,7 +90,6 @@ class ChatCompletionsClient(LLMClient):
         """
         self._model = model
         self._max_tokens = max_tokens
-        self._supports_audio_input = supports_audio_input
         self._reasoning_effort = reasoning_effort
         self._kwargs = kwargs or {}
 

{stirrup-0.1.2 → stirrup-0.1.4}/src/stirrup/clients/litellm_client.py

@@ -7,7 +7,7 @@ Requires the litellm extra: `pip install stirrup[litellm]`
 """
 
 import logging
-from typing import Any
+from typing import Any, Literal
 
 try:
     from litellm import acompletion
@@ -38,6 +38,8 @@ __all__ = [
 
 LOGGER = logging.getLogger(__name__)
 
+type ReasoningEffort = Literal["none", "minimal", "low", "medium", "high", "xhigh", "default"]
+
 
 class LiteLLMClient(LLMClient):
     """LiteLLM-based client supporting multiple LLM providers with unified interface.
@@ -49,8 +51,8 @@ class LiteLLMClient(LLMClient):
         self,
         model_slug: str,
         max_tokens: int,
-        supports_audio_input: bool = False,
-        reasoning_effort: str | None = None,
+        api_key: str | None = None,
+        reasoning_effort: ReasoningEffort | None = None,
         kwargs: dict[str, Any] | None = None,
     ) -> None:
         """Initialize LiteLLM client with model configuration and capabilities.
@@ -58,15 +60,13 @@ class LiteLLMClient(LLMClient):
         Args:
             model_slug: Model identifier for LiteLLM (e.g., 'anthropic/claude-3-5-sonnet-20241022')
             max_tokens: Maximum context window size in tokens
-            supports_audio_input: Whether the model supports audio inputs
             reasoning_effort: Reasoning effort level for extended thinking models (e.g., 'medium', 'high')
             kwargs: Additional arguments to pass to LiteLLM completion calls
         """
         self._model_slug = model_slug
-        self._supports_video_input = False
-        self._supports_audio_input = supports_audio_input
         self._max_tokens = max_tokens
-        self._reasoning_effort = reasoning_effort
+        self._reasoning_effort: ReasoningEffort | None = reasoning_effort
+        self._api_key = api_key
         self._kwargs = kwargs or {}
 
     @property
@@ -92,6 +92,8 @@ class LiteLLMClient(LLMClient):
             tools=to_openai_tools(tools) if tools else None,
             tool_choice="auto" if tools else None,
             max_tokens=self._max_tokens,
+            reasoning_effort=self._reasoning_effort,
+            api_key=self._api_key,
             **self._kwargs,
         )
 
@@ -103,14 +105,20 @@ class LiteLLMClient(LLMClient):
             )
 
         msg = choice["message"]
-
         reasoning: Reasoning | None = None
         if getattr(msg, "reasoning_content", None) is not None:
             reasoning = Reasoning(content=msg.reasoning_content)
         if getattr(msg, "thinking_blocks", None) is not None and len(msg.thinking_blocks) > 0:
-            reasoning = Reasoning(
-                signature=msg.thinking_blocks[0]["signature"], content=msg.thinking_blocks[0]["content"]
-            )
+            if len(msg.thinking_blocks) > 1:
+                raise ValueError("Found multiple thinking blocks in the response")
+
+            signature = msg.thinking_blocks[0].get("thinking_signature", None)
+            content = msg.thinking_blocks[0].get("thinking", None)
+
+            if signature is None and content is None:
+                raise ValueError("Signature and content not found in the thinking block response")
+
+            reasoning = Reasoning(signature=signature, content=content)
 
         usage = r["usage"]
 
@@ -119,6 +127,7 @@ class LiteLLMClient(LLMClient):
                 tool_call_id=tc.get("id"),
                 name=tc["function"]["name"],
                 arguments=tc["function"].get("arguments", "") or "",
+                signature=tc.get("provider_specific_fields", {}).get("thought_signature", None),
             )
             for tc in (msg.get("tool_calls") or [])
         ]