axio 0.8.0__tar.gz → 0.9.1__tar.gz

{axio-0.8.0 → axio-0.9.1}/PKG-INFO

@@ -1,14 +1,13 @@
 Metadata-Version: 2.4
 Name: axio
-Version: 0.8.0
+Version: 0.9.1
 Summary: Minimal, streaming-first, protocol-driven foundation for LLM-powered agents
 Project-URL: Homepage, https://github.com/mosquito/axio-agent
 Project-URL: Repository, https://github.com/mosquito/axio-agent
 License: MIT
 License-File: LICENSE
-Keywords: agent,ai,async,llm,protocol,pydantic,streaming
+Keywords: agent,ai,async,llm,protocol,streaming
 Requires-Python: >=3.12
-Requires-Dist: pydantic>=2
 Description-Content-Type: text/markdown
 
 # axio
@@ -19,16 +18,16 @@ Description-Content-Type: text/markdown
 
 Minimal, streaming-first, protocol-driven foundation for LLM-powered agents.
 
-One dependency (`pydantic`). Three protocols. An agent loop that just works.
+No dependencies. Three protocols. An agent loop that just works.
 
 ## Features
 
-- **Streaming agent loop** — `run_stream()` yields typed events as they arrive; no buffering, no polling
-- **Three clean protocols** — `CompletionTransport`, `ContextStore`, `PermissionGuard`; swap any piece without touching the rest
-- **Concurrent tool dispatch** — all tool calls in a turn run via `asyncio.gather` automatically
-- **Context compaction** — `compact_context()` summarises old history to stay within token limits
-- **Testing helpers** — `StubTransport`, `make_tool_use_response()`, `make_echo_tool()` ship in `axio.testing`
-- **Plugin-ready** — entry-point groups (`axio.tools`, `axio.transport`, `axio.guards`) for drop-in extensions
+- **Streaming agent loop** - `run_stream()` yields typed events as they arrive; no buffering, no polling
+- **Three clean protocols** - `CompletionTransport`, `ContextStore`, `PermissionGuard`; swap any piece without touching the rest
+- **Concurrent tool dispatch** - all tool calls in a turn run via `asyncio.gather` automatically
+- **Context compaction** - `compact_context()` summarises old history to stay within token limits
+- **Testing helpers** - `StubTransport`, `make_tool_use_response()`, `make_echo_tool()` ship in `axio.testing`
+- **Plugin-ready** - entry-point groups (`axio.tools`, `axio.transport`, `axio.guards`) for drop-in extensions
 
 ## Installation
 
@@ -57,17 +56,14 @@ sys.modules["axio_transport_openai"] = _m
 import asyncio
 from axio.agent import Agent
 from axio.context import MemoryContextStore
-from axio.tool import Tool, ToolHandler
+from axio.tool import Tool
 
 # 1. Define a tool
-class Greet(ToolHandler):
+async def greet(name: str) -> str:
     """Return a greeting for the given name."""
-    name: str
-
-    async def __call__(self) -> str:
-        return f"Hello, {self.name}!"
+    return f"Hello, {name}!"
 
-greet_tool = Tool(name="greet", description="Greet someone by name", handler=Greet)
+greet_tool = Tool(name="greet", description="Greet someone by name", handler=greet)
 
 # 2. Wire up the agent (transport comes from an axio-transport-* package)
 from axio_transport_openai import OpenAITransport
@@ -144,9 +140,9 @@ class MyContextStore(ContextStore):
     async def get_history(self) -> list[Message]:
         return list(self._messages)
 
-    # Everything else — session_id, close(), fork(), clear(),
+    # Everything else - session_id, close(), fork(), clear(),
     # get/set_context_tokens(), add_context_tokens(), list_sessions()
-    # — has a default implementation.
+    # - has a default implementation.
 ```
 
 ### PermissionGuard
@@ -158,11 +154,12 @@ class MyContextStore(ContextStore):
 ```python
 from typing import Any
 from axio.permission import PermissionGuard
+from axio.tool import Tool
 
 class MyGuard(PermissionGuard):
-    async def check(self, handler: Any) -> Any:
-        # return handler to allow, raise GuardError to deny
-        return handler
+    async def check(self, tool: Tool[Any], **kwargs: Any) -> dict[str, Any]:
+        # return kwargs to allow, raise GuardError to deny
+        return kwargs
 ```
 
 ## Stream events
@@ -173,29 +170,25 @@ class MyGuard(PermissionGuard):
 | `ToolUseStart` | Tool call begins (name + id) |
 | `ToolInputDelta` | Streaming JSON fragment for tool arguments |
 | `ToolResult` | Tool execution result |
-| `IterationEnd` | One LLM round complete — carries `Usage` + `StopReason` |
+| `IterationEnd` | One LLM round complete - carries `Usage` + `StopReason` |
 | `Error` | Transport or tool exception |
-| `SessionEndEvent` | Agent loop finished — carries total `Usage` |
+| `SessionEndEvent` | Agent loop finished - carries total `Usage` |
 
 ## Tools
 
 <!-- name: test_readme_tools -->
 ```python
-from axio.tool import Tool, ToolHandler
+from axio.tool import Tool
 
-class Summarise(ToolHandler):
+async def summarise(text: str, max_words: int = 20) -> str:
     """Summarise the given text in one sentence."""
-    text: str
-    max_words: int = 20
-
-    async def __call__(self) -> str:
-        # your implementation
-        return "..."
+    # your implementation
+    return "..."
 
 tool = Tool(
     name="summarise",
     description="Summarise text",   # overrides docstring if set
-    handler=Summarise,
+    handler=summarise,
     concurrency=4,                   # max parallel executions
 )
 ```

{axio-0.8.0 → axio-0.9.1}/README.md

@@ -6,16 +6,16 @@
 
 Minimal, streaming-first, protocol-driven foundation for LLM-powered agents.
 
-One dependency (`pydantic`). Three protocols. An agent loop that just works.
+No dependencies. Three protocols. An agent loop that just works.
 
 ## Features
 
-- **Streaming agent loop** — `run_stream()` yields typed events as they arrive; no buffering, no polling
-- **Three clean protocols** — `CompletionTransport`, `ContextStore`, `PermissionGuard`; swap any piece without touching the rest
-- **Concurrent tool dispatch** — all tool calls in a turn run via `asyncio.gather` automatically
-- **Context compaction** — `compact_context()` summarises old history to stay within token limits
-- **Testing helpers** — `StubTransport`, `make_tool_use_response()`, `make_echo_tool()` ship in `axio.testing`
-- **Plugin-ready** — entry-point groups (`axio.tools`, `axio.transport`, `axio.guards`) for drop-in extensions
+- **Streaming agent loop** - `run_stream()` yields typed events as they arrive; no buffering, no polling
+- **Three clean protocols** - `CompletionTransport`, `ContextStore`, `PermissionGuard`; swap any piece without touching the rest
+- **Concurrent tool dispatch** - all tool calls in a turn run via `asyncio.gather` automatically
+- **Context compaction** - `compact_context()` summarises old history to stay within token limits
+- **Testing helpers** - `StubTransport`, `make_tool_use_response()`, `make_echo_tool()` ship in `axio.testing`
+- **Plugin-ready** - entry-point groups (`axio.tools`, `axio.transport`, `axio.guards`) for drop-in extensions
 
 ## Installation
 
@@ -44,17 +44,14 @@ sys.modules["axio_transport_openai"] = _m
 import asyncio
 from axio.agent import Agent
 from axio.context import MemoryContextStore
-from axio.tool import Tool, ToolHandler
+from axio.tool import Tool
 
 # 1. Define a tool
-class Greet(ToolHandler):
+async def greet(name: str) -> str:
     """Return a greeting for the given name."""
-    name: str
-
-    async def __call__(self) -> str:
-        return f"Hello, {self.name}!"
+    return f"Hello, {name}!"
 
-greet_tool = Tool(name="greet", description="Greet someone by name", handler=Greet)
+greet_tool = Tool(name="greet", description="Greet someone by name", handler=greet)
 
 # 2. Wire up the agent (transport comes from an axio-transport-* package)
 from axio_transport_openai import OpenAITransport
@@ -131,9 +128,9 @@ class MyContextStore(ContextStore):
     async def get_history(self) -> list[Message]:
         return list(self._messages)
 
-    # Everything else — session_id, close(), fork(), clear(),
+    # Everything else - session_id, close(), fork(), clear(),
     # get/set_context_tokens(), add_context_tokens(), list_sessions()
-    # — has a default implementation.
+    # - has a default implementation.
 ```
 
 ### PermissionGuard
@@ -145,11 +142,12 @@ class MyContextStore(ContextStore):
 ```python
 from typing import Any
 from axio.permission import PermissionGuard
+from axio.tool import Tool
 
 class MyGuard(PermissionGuard):
-    async def check(self, handler: Any) -> Any:
-        # return handler to allow, raise GuardError to deny
-        return handler
+    async def check(self, tool: Tool[Any], **kwargs: Any) -> dict[str, Any]:
+        # return kwargs to allow, raise GuardError to deny
+        return kwargs
 ```
 
 ## Stream events
@@ -160,29 +158,25 @@ class MyGuard(PermissionGuard):
 | `ToolUseStart` | Tool call begins (name + id) |
 | `ToolInputDelta` | Streaming JSON fragment for tool arguments |
 | `ToolResult` | Tool execution result |
-| `IterationEnd` | One LLM round complete — carries `Usage` + `StopReason` |
+| `IterationEnd` | One LLM round complete - carries `Usage` + `StopReason` |
 | `Error` | Transport or tool exception |
-| `SessionEndEvent` | Agent loop finished — carries total `Usage` |
+| `SessionEndEvent` | Agent loop finished - carries total `Usage` |
 
 ## Tools
 
 <!-- name: test_readme_tools -->
 ```python
-from axio.tool import Tool, ToolHandler
+from axio.tool import Tool
 
-class Summarise(ToolHandler):
+async def summarise(text: str, max_words: int = 20) -> str:
     """Summarise the given text in one sentence."""
-    text: str
-    max_words: int = 20
-
-    async def __call__(self) -> str:
-        # your implementation
-        return "..."
+    # your implementation
+    return "..."
 
 tool = Tool(
     name="summarise",
     description="Summarise text",   # overrides docstring if set
-    handler=Summarise,
+    handler=summarise,
     concurrency=4,                   # max parallel executions
 )
 ```

{axio-0.8.0 → axio-0.9.1}/pyproject.toml

@@ -1,12 +1,12 @@
 [project]
 name = "axio"
-version = "0.8.0"
+version = "0.9.1"  # 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"
 license = {text = "MIT"}
-keywords = ["llm", "agent", "ai", "async", "streaming", "pydantic", "protocol"]
-dependencies = ["pydantic>=2"]
+keywords = ["llm", "agent", "ai", "async", "streaming", "protocol"]
+dependencies = []
 
 
 [project.urls]
@@ -25,6 +25,7 @@ testpaths = ["tests", "README.md"]
 
 [tool.ruff]
 line-length = 119
+output-format = "concise"
 target-version = "py312"
 
 [tool.ruff.lint]
@@ -34,6 +35,7 @@ select = ["E", "F", "I", "UP"]
 strict = true
 python_version = "3.12"
 
+
 [dependency-groups]
 dev = [
     "pytest>=8",

axio-0.9.1/src/axio/__init__.py

@@ -0,0 +1,74 @@
+"""axio - public API."""
+
+from .agent import Agent
+from .blocks import TextBlock, ToolResultBlock, ToolUseBlock
+from .context import ContextStore, MemoryContextStore
+from .events import (
+    AudioOutputDelta,
+    IterationEnd,
+    SpeechStarted,
+    SpeechStopped,
+    StreamEvent,
+    TextDelta,
+    ToolInputDelta,
+    ToolResult,
+    ToolUseStart,
+    TranscriptDelta,
+    TurnComplete,
+)
+from .exceptions import GuardError, HandlerError
+from .field import Field, FieldInfo, StrictStr
+from .messages import Message
+from .permission import ConcurrentGuard, PermissionGuard
+from .realtime import RealtimeAgent
+from .selector import ToolSelector
+from .stream import AgentStream
+from .tool import CONTEXT, Tool
+from .transport import CompletionTransport, RealtimeSession, RealtimeTransport
+from .types import StopReason, Usage
+
+__all__ = [
+    # core
+    "Agent",
+    "Tool",
+    "CONTEXT",
+    "ContextStore",
+    "MemoryContextStore",
+    "CompletionTransport",
+    # events
+    "StreamEvent",
+    "TextDelta",
+    "IterationEnd",
+    "ToolUseStart",
+    "ToolInputDelta",
+    "ToolResult",
+    # realtime
+    "RealtimeAgent",
+    "RealtimeTransport",
+    "RealtimeSession",
+    "AudioOutputDelta",
+    "TranscriptDelta",
+    "SpeechStarted",
+    "SpeechStopped",
+    "TurnComplete",
+    # messages & blocks
+    "Message",
+    "TextBlock",
+    "ToolUseBlock",
+    "ToolResultBlock",
+    # types & errors
+    "StopReason",
+    "Usage",
+    "GuardError",
+    "HandlerError",
+    # permissions
+    "PermissionGuard",
+    "ConcurrentGuard",
+    # field annotations
+    "Field",
+    "FieldInfo",
+    "StrictStr",
+    # advanced
+    "ToolSelector",
+    "AgentStream",
+]