stirrup 0.1.3__py3-none-any.whl → 0.1.4__py3-none-any.whl

stirrup/tools/finish.py

@@ -1,3 +1,7 @@
+"""Simple finish tool with file existence validation."""
+
+from __future__ import annotations
+
 from typing import Annotated
 
 from pydantic import BaseModel, Field
@@ -15,9 +19,31 @@ class FinishParams(BaseModel):
     ]
 
 
+async def _validating_finish_executor(params: FinishParams) -> ToolResult[ToolUseCountMetadata]:
+    """Validates all reported files exist before completing."""
+    from stirrup.core.agent import _SESSION_STATE
+
+    try:
+        state = _SESSION_STATE.get(None)
+        exec_env = state.exec_env if state else None
+    except LookupError:
+        exec_env = None
+
+    if exec_env and params.paths:
+        missing = [p for p in params.paths if not await exec_env.file_exists(p)]
+        if missing:
+            return ToolResult(
+                content=f"ERROR: Files do not exist: {missing}. Verify paths and ensure files were saved.",
+                metadata=ToolUseCountMetadata(),
+                success=False,
+            )
+
+    return ToolResult(content=params.reason, metadata=ToolUseCountMetadata(), success=True)
+
+
 SIMPLE_FINISH_TOOL: Tool[FinishParams, ToolUseCountMetadata] = Tool[FinishParams, ToolUseCountMetadata](
     name=FINISH_TOOL_NAME,
     description="Signal task completion with a reason. Use when the task is finished or cannot proceed further. Note that you will need a separate turn to finish.",
     parameters=FinishParams,
-    executor=lambda params: ToolResult(content=params.reason, metadata=ToolUseCountMetadata(), success=True),
+    executor=_validating_finish_executor,
 )

stirrup/utils/logging.py

@@ -23,6 +23,7 @@ from rich.text import Text
 from rich.tree import Tree
 
 from stirrup.core.models import AssistantMessage, ToolMessage, UserMessage, _aggregate_list, aggregate_metadata
+from stirrup.utils.text import truncate_msg
 
 __all__ = [
     "AgentLogger",
@@ -769,11 +770,12 @@ class AgentLogger(AgentLoggerBase):
                 content.append("\n\n")
             content.append("Tool Calls:\n", style="bold magenta")
             for tc in assistant_message.tool_calls:
-                args_parsed = json.loads(tc.arguments)
-                args_formatted = json.dumps(args_parsed, indent=2, ensure_ascii=False)
-                args_preview = args_formatted[:1000] + "..." if len(args_formatted) > 1000 else args_formatted
                 content.append(f"  🔧 {tc.name}", style="magenta")
-                content.append(args_preview, style="dim")
+                if tc.arguments and tc.arguments.strip():
+                    args_parsed = json.loads(tc.arguments)
+                    args_formatted = json.dumps(args_parsed, indent=2, ensure_ascii=False)
+                    args_preview = args_formatted[:1000] + "..." if len(args_formatted) > 1000 else args_formatted
+                    content.append(args_preview, style="dim")
 
         # Create and print panel with agent name in title
         title = f"[bold]AssistantMessage[/bold] │ {self.name} │ Turn {turn}/{max_turns}"
@@ -875,9 +877,8 @@ class AgentLogger(AgentLoggerBase):
         # Unescape HTML entities (e.g., &lt; -> <, &gt; -> >, &amp; -> &)
         result_text = html.unescape(result_text)
 
-        # Truncate long results
-        if len(result_text) > 1000:
-            result_text = result_text[:1000] + "..."
+        # Truncate long results (keeps start and end, removes middle)
+        result_text = truncate_msg(result_text, 1000)
 
         # Format as XML with syntax highlighting
         content = Syntax(result_text, "xml", theme="monokai", word_wrap=True)

{stirrup-0.1.3.dist-info → stirrup-0.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: stirrup
-Version: 0.1.3
+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.3.dist-info → stirrup-0.1.4.dist-info}/RECORD

@@ -1,14 +1,15 @@
 stirrup/__init__.py,sha256=4p5Rw7f_wdxVu1FJTgJROe0aTlnc8tOsainBEzDRGEY,1905
-stirrup/clients/__init__.py,sha256=oO8VMHmbUhoxFyC0JLQs_kUFNSRlvTj5xz0FgzBb98E,405
+stirrup/clients/__init__.py,sha256=vHtR1rqK7w9LMWCBJXJde_R1pwdbuj9f6AbAJ4ib3xk,622
 stirrup/clients/chat_completions_client.py,sha256=P0VOGFQcfLIVf7zCGYbopQDjNVEJlpeLBeGvB87sQQg,7390
 stirrup/clients/litellm_client.py,sha256=2ZrZKKAEV2dEFs6ze4qBl3it5VwiGH8s7wHVuHdw-uY,5507
+stirrup/clients/open_responses_client.py,sha256=AEM2z_LZhT4hW7VUSFb4mqzV5q_mavnLCwiBTUmt340,15303
 stirrup/clients/utils.py,sha256=Z_8KiENDZVD9fChUm7PA-RLhvoChswHVQsjrHXlIfkg,5684
 stirrup/constants.py,sha256=WpVPm2jRN2AqYMyoMYeJimiggoquP7M3IrcHNpduFF4,644
 stirrup/core/__init__.py,sha256=ReBVl7B9h_FNkZ77vCx2xlfuK1JuQ0yTSXrEgc4tONU,39
-stirrup/core/agent.py,sha256=2KxjuCy3scLRc59habPSZyYDCHL9a9--UcdFKYV-86w,56907
+stirrup/core/agent.py,sha256=I-SDjXxUOYSVxowy7SHXP_bjEEZD2JIouNnS7VarmxI,58120
 stirrup/core/cache.py,sha256=lAbbBJzgYInewoBBPMzNooroU2Q7JbF21riggfdIDa8,16697
 stirrup/core/exceptions.py,sha256=CzLVAi7Ns-t9BWSkqQUCB7ypVHAesV2s4a09-i0NXyQ,213
-stirrup/core/models.py,sha256=qMmpecRIl8sKdUePtoVChKA3rBHxzG8lI4ZvuLFHNzo,22553
+stirrup/core/models.py,sha256=hAwquChulASzwf0yirmsWkfgBEnLTxX9pTAkJ7CwVvM,22591
 stirrup/prompts/__init__.py,sha256=e4bpTktBaFPuO_bIW5DelGNWtT6_NIUqnD2lRv8n89I,796
 stirrup/prompts/base_system_prompt.txt,sha256=D_UlDWEnG2yaPCMFrE7IqMHI8VCzi4BZ-GnuL3qs5q4,288
 stirrup/prompts/message_summarizer.txt,sha256=uQoTxreMuC42rTGSZmoH1Dnj06WrEQb0gLkDvVMhosQ,1173
@@ -16,21 +17,22 @@ stirrup/prompts/message_summarizer_bridge.txt,sha256=sWbfnHtI6RWemBIyQsnqHMGpnU-
 stirrup/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 stirrup/skills/__init__.py,sha256=BEcmdSskfBzx_QK4eKXECucndIKRjHXzzwwwsaez8k4,700
 stirrup/skills/skills.py,sha256=qhA3HI55kaRqLyvn_56Cs71833Xacg-8qP7muHrwruE,4282
-stirrup/tools/__init__.py,sha256=l8bKHZwPBZfBPgxQfLzOKyyzdfoF86NrgdmxhjYW09s,2790
+stirrup/tools/__init__.py,sha256=TJ3AqPhAkfVPboyMGHscIfq-oUc8brPPVnKtUrf9ICU,2879
+stirrup/tools/browser_use.py,sha256=m7y5F9mO_Qhitmpu6NFh9-wYAxqgXb4_T3VuZdgGInM,21111
 stirrup/tools/calculator.py,sha256=Cckt-8TtltxtuyY_Hh0wOr8efUzBZzg7rG4dBpvpuRM,1293
 stirrup/tools/code_backends/__init__.py,sha256=O3Rs76r0YcQ27voTrx_zuhIEFawK3b1TQdKi70MORG8,987
-stirrup/tools/code_backends/base.py,sha256=5mQxbHoOvtTdiF1y1aVe4csodaCOGvHaVN5viRnUlUE,17250
-stirrup/tools/code_backends/docker.py,sha256=Xx4aBZ1uXVznP0qV4tXL2PMMs-8QEPw1bIPvgPasEGk,30281
-stirrup/tools/code_backends/e2b.py,sha256=4I5Aqas-4PVhYgMhIAQh3xcwl_0kGiUpo64UU9-awfE,14921
-stirrup/tools/code_backends/local.py,sha256=snzbWHnZkVu1ibLLRyRVmi6U9-8407_A0sKbdDNyTe4,19600
-stirrup/tools/finish.py,sha256=zdljSs77zMVkA2AGUfV05QmeLxz6JrwJF_ar02yvsVA,950
+stirrup/tools/code_backends/base.py,sha256=aOX09b4sCxjtFecnnklE_dINIfQ_lH3oYZJ3-N7rCMA,17720
+stirrup/tools/code_backends/docker.py,sha256=6zeOL40peNGu3XGEzP6iwVIZmpr2TjENkllt5DZjHr4,30884
+stirrup/tools/code_backends/e2b.py,sha256=hhaDVOYKxbYHIUhFw5kv-Pri0Sb3a-Weh5Zw5H0tyKM,15396
+stirrup/tools/code_backends/local.py,sha256=6D6QnGYyspQbJ5HOaDke-asGc0-W55p-Nh5ABQkzjG0,20125
+stirrup/tools/finish.py,sha256=xprl0z1N_e-8VddLyEIA9pLeMXjh5A9d4LpkKxhOh5A,1803
 stirrup/tools/mcp.py,sha256=4wWYae95y8Bs7e36hHwnxRfVVj0PABrsRStw492lLaw,18749
 stirrup/tools/user_input.py,sha256=XwK14FvRQly3vGwgNzPVGoSXfbco0WWaSVpTDyjV09E,4508
 stirrup/tools/view_image.py,sha256=zazCpZMtLOD6lplLPYGNQ8JeYfc0oUDJoUUyVAp3AMU,3126
 stirrup/tools/web.py,sha256=B-zp5i1WhjOOMAlYtnvU3N5hNYnJYm8qVXAtNx_ZaRw,12292
 stirrup/utils/__init__.py,sha256=4kcuExrphSXqgxRgu1q8_Z6Rrb9aAZpIo4Xq4S9Twuk,230
-stirrup/utils/logging.py,sha256=48rCzv7B15jiVM1JlKzwTSnGodbqGSKLlsZi9xRMmVM,35045
+stirrup/utils/logging.py,sha256=vZ7P7MotZnjbTyhMZ0p1YVTGhKQBAXBHOGbku3gEzuk,35166
 stirrup/utils/text.py,sha256=3lGlcXFzQ-Mclsbu7wJciG3CcHvQ_Sk98tqOZxYLlGw,479
-stirrup-0.1.3.dist-info/WHEEL,sha256=KSLUh82mDPEPk0Bx0ScXlWL64bc8KmzIPNcpQZFV-6E,79
-stirrup-0.1.3.dist-info/METADATA,sha256=EyJEJTRFzLoSXnkBPauFvskBgMwJDJ8O2Vm8HdJPdsI,12862
-stirrup-0.1.3.dist-info/RECORD,,
+stirrup-0.1.4.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
+stirrup-0.1.4.dist-info/METADATA,sha256=tJvHDTGB-Tfh4YqJVzyny9GAHqd6aZdqhpYG5apy3p8,13304
+stirrup-0.1.4.dist-info/RECORD,,

{stirrup-0.1.3.dist-info → stirrup-0.1.4.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.22
+Generator: uv 0.9.26
 Root-Is-Purelib: true
-Tag: py3-none-any
+Tag: py3-none-any