axio 0.11.2__tar.gz → 0.11.3__tar.gz

{axio-0.11.2 → axio-0.11.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: axio
-Version: 0.11.2
+Version: 0.11.3
 Summary: Minimal, streaming-first, protocol-driven foundation for LLM-powered agents
 Project-URL: Documentation, https://docs.axio-agent.com
 Project-URL: Homepage, https://github.com/mosquito/axio-agent
@@ -49,9 +49,13 @@ import sys, types
 from axio.testing import StubTransport, make_text_response
 
 _m = types.ModuleType("axio_transport_openai")
+
+
 class OpenAITransport(StubTransport):
     def __init__(self, api_key: str = "", model: str = "") -> None:
         super().__init__([make_text_response("Hello, Alice!")])
+
+
 _m.OpenAITransport = OpenAITransport  # type: ignore[attr-defined]
 sys.modules["axio_transport_openai"] = _m
 ```
@@ -63,11 +67,13 @@ from axio.agent import Agent
 from axio.context import MemoryContextStore
 from axio.tool import Tool
 
+
 # 1. Define a tool
 async def greet(name: str) -> str:
     """Return a greeting for the given name."""
     return f"Hello, {name}!"
 
+
 greet_tool = Tool(name="greet", description="Greet someone by name", handler=greet)
 
 # 2. Wire up the agent (transport comes from an axio-transport-* package)
@@ -76,12 +82,14 @@ from axio_transport_openai import OpenAITransport
 transport = OpenAITransport(api_key="sk-...", model="gpt-4o-mini")
 agent = Agent(system="You are helpful.", transport=transport, tools=[greet_tool])
 
+
 # 3. Run
 async def main() -> None:
     ctx = MemoryContextStore()
     async for event in agent.run_stream("Please greet Alice", ctx):
         print(event)
 
+
 asyncio.run(main())
 ```
 
@@ -121,11 +129,10 @@ from axio.events import StreamEvent
 from axio.messages import Message
 from axio.tool import Tool
 
+
 @runtime_checkable
 class CompletionTransport(Protocol):
-    def stream(
-        self, messages: list[Message], tools: list[Tool], system: str
-    ) -> AsyncIterator[StreamEvent]: ...
+    def stream(self, messages: list[Message], tools: list[Tool], system: str) -> AsyncIterator[StreamEvent]: ...
 ```
 
 ### ContextStore
@@ -135,6 +142,7 @@ class CompletionTransport(Protocol):
 from axio.context import ContextStore
 from axio.messages import Message
 
+
 class MyContextStore(ContextStore):
     def __init__(self) -> None:
         self._messages: list[Message] = []
@@ -161,6 +169,7 @@ from typing import Any
 from axio.permission import PermissionGuard
 from axio.tool import Tool
 
+
 class MyGuard(PermissionGuard):
     async def check(self, tool: Tool[Any], **kwargs: Any) -> dict[str, Any]:
         # return kwargs to allow, raise GuardError to deny
@@ -185,16 +194,18 @@ class MyGuard(PermissionGuard):
 ```python
 from axio.tool import Tool
 
+
 async def summarise(text: str, max_words: int = 20) -> str:
     """Summarise the given text in one sentence."""
     # your implementation
     return "..."
 
+
 tool = Tool(
     name="summarise",
-    description="Summarise text",   # overrides docstring if set
+    description="Summarise text",  # overrides docstring if set
     handler=summarise,
-    concurrency=4,                   # max parallel executions
+    concurrency=4,  # max parallel executions
 )
 ```
 
@@ -211,11 +222,14 @@ from axio.testing import (
     make_echo_tool,
 )
 
+
 async def test_agent_calls_tool():
-    transport = StubTransport([
-        make_tool_use_response("echo", tool_input={"msg": "hi"}),
-        make_text_response("Done"),
-    ])
+    transport = StubTransport(
+        [
+            make_tool_use_response("echo", tool_input={"msg": "hi"}),
+            make_text_response("Done"),
+        ]
+    )
     agent = Agent(system="", tools=[make_echo_tool()], transport=transport)
     result = await agent.run("say hi", make_ephemeral_context())
     assert result == "Done"

{axio-0.11.2 → axio-0.11.3}/README.md

@@ -32,9 +32,13 @@ import sys, types
 from axio.testing import StubTransport, make_text_response
 
 _m = types.ModuleType("axio_transport_openai")
+
+
 class OpenAITransport(StubTransport):
     def __init__(self, api_key: str = "", model: str = "") -> None:
         super().__init__([make_text_response("Hello, Alice!")])
+
+
 _m.OpenAITransport = OpenAITransport  # type: ignore[attr-defined]
 sys.modules["axio_transport_openai"] = _m
 ```
@@ -46,11 +50,13 @@ from axio.agent import Agent
 from axio.context import MemoryContextStore
 from axio.tool import Tool
 
+
 # 1. Define a tool
 async def greet(name: str) -> str:
     """Return a greeting for the given name."""
     return f"Hello, {name}!"
 
+
 greet_tool = Tool(name="greet", description="Greet someone by name", handler=greet)
 
 # 2. Wire up the agent (transport comes from an axio-transport-* package)
@@ -59,12 +65,14 @@ from axio_transport_openai import OpenAITransport
 transport = OpenAITransport(api_key="sk-...", model="gpt-4o-mini")
 agent = Agent(system="You are helpful.", transport=transport, tools=[greet_tool])
 
+
 # 3. Run
 async def main() -> None:
     ctx = MemoryContextStore()
     async for event in agent.run_stream("Please greet Alice", ctx):
         print(event)
 
+
 asyncio.run(main())
 ```
 
@@ -104,11 +112,10 @@ from axio.events import StreamEvent
 from axio.messages import Message
 from axio.tool import Tool
 
+
 @runtime_checkable
 class CompletionTransport(Protocol):
-    def stream(
-        self, messages: list[Message], tools: list[Tool], system: str
-    ) -> AsyncIterator[StreamEvent]: ...
+    def stream(self, messages: list[Message], tools: list[Tool], system: str) -> AsyncIterator[StreamEvent]: ...
 ```
 
 ### ContextStore
@@ -118,6 +125,7 @@ class CompletionTransport(Protocol):
 from axio.context import ContextStore
 from axio.messages import Message
 
+
 class MyContextStore(ContextStore):
     def __init__(self) -> None:
         self._messages: list[Message] = []
@@ -144,6 +152,7 @@ from typing import Any
 from axio.permission import PermissionGuard
 from axio.tool import Tool
 
+
 class MyGuard(PermissionGuard):
     async def check(self, tool: Tool[Any], **kwargs: Any) -> dict[str, Any]:
         # return kwargs to allow, raise GuardError to deny
@@ -168,16 +177,18 @@ class MyGuard(PermissionGuard):
 ```python
 from axio.tool import Tool
 
+
 async def summarise(text: str, max_words: int = 20) -> str:
     """Summarise the given text in one sentence."""
     # your implementation
     return "..."
 
+
 tool = Tool(
     name="summarise",
-    description="Summarise text",   # overrides docstring if set
+    description="Summarise text",  # overrides docstring if set
     handler=summarise,
-    concurrency=4,                   # max parallel executions
+    concurrency=4,  # max parallel executions
 )
 ```
 
@@ -194,11 +205,14 @@ from axio.testing import (
     make_echo_tool,
 )
 
+
 async def test_agent_calls_tool():
-    transport = StubTransport([
-        make_tool_use_response("echo", tool_input={"msg": "hi"}),
-        make_text_response("Done"),
-    ])
+    transport = StubTransport(
+        [
+            make_tool_use_response("echo", tool_input={"msg": "hi"}),
+            make_text_response("Done"),
+        ]
+    )
     agent = Agent(system="", tools=[make_echo_tool()], transport=transport)
     result = await agent.run("say hi", make_ephemeral_context())
     assert result == "Done"

{axio-0.11.2 → axio-0.11.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "axio"
-version = "0.11.2"  # bumped to the git tag by CI on publish
+version = "0.11.3"  # bumped to the git tag by CI on publish
 description = "Minimal, streaming-first, protocol-driven foundation for LLM-powered agents"
 readme = "README.md"
 requires-python = ">=3.12"