agentropic 0.2.2__tar.gz → 0.3.0__tar.gz

{agentropic-0.2.2 → agentropic-0.3.0}/.gitignore

@@ -1,9 +1,9 @@
-__pycache__/
-*.pyc
-.venv/
-venv/
-dist/
-build/
-*.egg-info/
-.pytest_cache/
-.env
+__pycache__/
+*.pyc
+.venv/
+venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.env

{agentropic-0.2.2 → agentropic-0.3.0}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Your Name
-
-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.
+MIT License
+
+Copyright (c) 2026 Your Name
+
+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.

{agentropic-0.2.2 → agentropic-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: agentropic
-Version: 0.2.2
+Version: 0.3.0
 Summary: A minimal, hackable agentic framework: LLM calls via litellm, @tool-decorated functions, and MCP server support.
 Author-email: Vishal Tiwari <vishaltiwari.up2019@gmail.com>
 License: MIT
@@ -70,23 +70,52 @@ asyncio.run(main())
 
 Sync usage: `agent.run("...")` (wraps `arun` in `asyncio.run` for you).
 
+## Streaming (`stream=True`)
+
+Same shape as the OpenAI / Anthropic SDKs. Tool calls work while streaming.
+
+```python
+async for event in await agent.arun("Weather in Tokyo?", stream=True):
+    if event.type == "text":
+        print(event.text, end="", flush=True)
+    elif event.type == "tool_call":
+        print(f"\n[calling {event.tool_call.name}({event.tool_call.arguments})]")
+    elif event.type == "tool_result":
+        print(f"[-> {event.tool_call.result}]")
+    elif event.type == "done":
+        result = event.result          # full AgentRunResult (usage, tool_calls, ...)
+```
+
+Sync: `for event in agent.run("...", stream=True): ...`
+Text only: `async for token in agent.astream("..."): ...`
+
 ## Using MCP servers
 
 ```python
 from agentropic import Agent
-from agentropic.mcp import StdioServer
+from agentropic.mcp import StdioServer, HTTPServer
 
 agent = Agent(
     name="fs-agent",
     model="gpt-4o-mini",
     mcp_servers=[
         StdioServer(command="npx", args=["-y", "@modelcontextprotocol/server-filesystem", "."]),
+        # HTTPServer(url="https://example.com/mcp", headers={"Authorization": "Bearer ..."}),
     ],
 )
+
+# Option A: connect once, keep servers alive across turns (recommended)
+async with agent:
+    print(await agent.arun("List the files in the current directory."))
+    print(await agent.arun("Now read README.md"))
+
+# Option B: no context manager — servers connect/disconnect around each run
 print(await agent.arun("List the files in the current directory."))
 ```
 
-Requires the optional MCP dependency: `pip install "agentropic[mcp]"`.
+Requires the optional MCP dependency: `pip install "agentropic[mcp]"`, plus whatever
+the server itself needs (e.g. Node.js for `npx` servers). Transports: `StdioServer`,
+`HTTPServer` (streamable HTTP), `SSEServer` (legacy SSE).
 
 ## Architecture
 
@@ -108,9 +137,6 @@ registry you can't inspect. Read `agent.py` first; that's the whole loop.
 
 - **Custom memory / persistence**: implement `.add()`, `.get()`, `.clear()`
   matching `Memory` and pass `memory=YourMemory()` to `Agent`.
-- **Streaming with tool calls**: `astream()` currently falls back to a
-  non-streamed `arun()` when tools are registered — extend it if you need
-  token-level streaming mid-tool-loop.
 - **Multi-agent handoff**: compose multiple `Agent` instances and route
   between them yourself, or wrap one agent's `arun` as a tool for another.
 

{agentropic-0.2.2 → agentropic-0.3.0}/README.md

@@ -44,23 +44,52 @@ asyncio.run(main())
 
 Sync usage: `agent.run("...")` (wraps `arun` in `asyncio.run` for you).
 
+## Streaming (`stream=True`)
+
+Same shape as the OpenAI / Anthropic SDKs. Tool calls work while streaming.
+
+```python
+async for event in await agent.arun("Weather in Tokyo?", stream=True):
+    if event.type == "text":
+        print(event.text, end="", flush=True)
+    elif event.type == "tool_call":
+        print(f"\n[calling {event.tool_call.name}({event.tool_call.arguments})]")
+    elif event.type == "tool_result":
+        print(f"[-> {event.tool_call.result}]")
+    elif event.type == "done":
+        result = event.result          # full AgentRunResult (usage, tool_calls, ...)
+```
+
+Sync: `for event in agent.run("...", stream=True): ...`
+Text only: `async for token in agent.astream("..."): ...`
+
 ## Using MCP servers
 
 ```python
 from agentropic import Agent
-from agentropic.mcp import StdioServer
+from agentropic.mcp import StdioServer, HTTPServer
 
 agent = Agent(
     name="fs-agent",
     model="gpt-4o-mini",
     mcp_servers=[
         StdioServer(command="npx", args=["-y", "@modelcontextprotocol/server-filesystem", "."]),
+        # HTTPServer(url="https://example.com/mcp", headers={"Authorization": "Bearer ..."}),
     ],
 )
+
+# Option A: connect once, keep servers alive across turns (recommended)
+async with agent:
+    print(await agent.arun("List the files in the current directory."))
+    print(await agent.arun("Now read README.md"))
+
+# Option B: no context manager — servers connect/disconnect around each run
 print(await agent.arun("List the files in the current directory."))
 ```
 
-Requires the optional MCP dependency: `pip install "agentropic[mcp]"`.
+Requires the optional MCP dependency: `pip install "agentropic[mcp]"`, plus whatever
+the server itself needs (e.g. Node.js for `npx` servers). Transports: `StdioServer`,
+`HTTPServer` (streamable HTTP), `SSEServer` (legacy SSE).
 
 ## Architecture
 
@@ -82,9 +111,6 @@ registry you can't inspect. Read `agent.py` first; that's the whole loop.
 
 - **Custom memory / persistence**: implement `.add()`, `.get()`, `.clear()`
   matching `Memory` and pass `memory=YourMemory()` to `Agent`.
-- **Streaming with tool calls**: `astream()` currently falls back to a
-  non-streamed `arun()` when tools are registered — extend it if you need
-  token-level streaming mid-tool-loop.
 - **Multi-agent handoff**: compose multiple `Agent` instances and route
   between them yourself, or wrap one agent's `arun` as a tool for another.
 

{agentropic-0.2.2 → agentropic-0.3.0}/examples/basic_agent.py

@@ -31,7 +31,7 @@ async def main():
         tools=[get_weather, add],
         # Optional: pull in tools from a live MCP server too.
         # mcp_servers=[StdioServer(command="npx", args=["-y", "@modelcontextprotocol/server-filesystem", "."])],
-        max_iterations=2,
+        max_iterations=5,
     )
 
     result = await agent.arun("What's the weather in Tokyo, and what's 12 + 30?")
@@ -55,6 +55,16 @@ async def main():
     result2 = await agent.arun("Say that last sum again, but doubled.")
     print(result2.output)
 
+    # Streaming (stream=True): tokens + tool events as they happen.
+    print("\n--- streaming ---")
+    async for event in await agent.arun("Weather in Delhi? Answer in one sentence.", stream=True):
+        if event.type == "text":
+            print(event.text, end="", flush=True)
+        elif event.type == "tool_call":
+            print(f"[calling {event.tool_call.name}({event.tool_call.arguments})]")
+        elif event.type == "done":
+            print("\nTokens:", event.result.usage)
+
 
 if __name__ == "__main__":
     asyncio.run(main())

{agentropic-0.2.2 → agentropic-0.3.0}/pyproject.toml

@@ -1,34 +1,34 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "agentropic"
-version = "0.2.2"
-description = "A minimal, hackable agentic framework: LLM calls via litellm, @tool-decorated functions, and MCP server support."
-readme = "README.md"
-requires-python = ">=3.9"
-license = { text = "MIT" }
-authors = [
-    { name = "Vishal Tiwari", email = "vishaltiwari.up2019@gmail.com" }
-]
-keywords = ["llm", "agent", "agents", "litellm", "mcp", "tools", "ai"]
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: OS Independent",
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Developers",
-    "Topic :: Software Development :: Libraries :: Python Modules",
-]
-dependencies = [
-    "litellm>=1.40.0",
-    "pydantic>=2.0.0",
-]
-
-[project.optional-dependencies]
-mcp = ["mcp>=1.0.0"]
-dev = ["pytest", "pytest-asyncio", "build", "twine"]
-
-[tool.hatch.build.targets.wheel]
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agentropic"
+version = "0.3.0"
+description = "A minimal, hackable agentic framework: LLM calls via litellm, @tool-decorated functions, and MCP server support."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "Vishal Tiwari", email = "vishaltiwari.up2019@gmail.com" }
+]
+keywords = ["llm", "agent", "agents", "litellm", "mcp", "tools", "ai"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "litellm>=1.40.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+mcp = ["mcp>=1.0.0"]
+dev = ["pytest", "pytest-asyncio", "build", "twine"]
+
+[tool.hatch.build.targets.wheel]
 packages = ["src/agentropic"]

{agentropic-0.2.2 → agentropic-0.3.0}/src/agentropic/__init__.py

@@ -1,27 +1,27 @@
-from .agent import Agent, AgentError, AgentRunResult, ToolCallRecord
-from .tools import tool, Tool, ToolRegistry
-from .llm import LLMClient, LLMResponse
-from .memory import Memory
-from .mcp.client import MCPConnection, StdioServer, SSEServer, MCPServerConfig
-from .tracing import AgentTracer, NullTracer
-
-__version__ = "0.2.0"
-
-__all__ = [
-    "Agent",
-    "AgentError",
-    "AgentRunResult",
-    "ToolCallRecord",
-    "tool",
-    "Tool",
-    "ToolRegistry",
-    "LLMClient",
-    "LLMResponse",
-    "Memory",
-    "MCPConnection",
-    "StdioServer",
-    "SSEServer",
-    "MCPServerConfig",
-    "AgentTracer",
-    "NullTracer",
+from .agent import Agent, AgentError, AgentRunResult, StreamEvent, ToolCallRecord
+from .tools import tool, Tool, ToolRegistry
+from .llm import LLMClient, LLMResponse
+from .memory import Memory
+from .mcp.client import MCPConnection, MCPError, StdioServer, SSEServer, HTTPServer, MCPServerConfig
+
+__version__ = "0.3.0"
+
+__all__ = [
+    "Agent",
+    "AgentError",
+    "AgentRunResult",
+    "StreamEvent",
+    "ToolCallRecord",
+    "MCPError",
+    "HTTPServer",
+    "tool",
+    "Tool",
+    "ToolRegistry",
+    "LLMClient",
+    "LLMResponse",
+    "Memory",
+    "MCPConnection",
+    "StdioServer",
+    "SSEServer",
+    "MCPServerConfig",
 ]