RouteKitAI 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

routekitai/__init__.py

@@ -1,6 +1,6 @@
 """RouteKitAI: An agent development + orchestration framework."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 
 # Import hooks first to ensure ToolFilter is defined before Agent
 from routekitai.core import (

routekitai/core/policies.py

@@ -25,7 +25,8 @@ class ReActPolicy(Policy):
     Simple loop: model -> decide tool -> tool -> model -> final
     """
 
-    max_iterations: int = 10
+    def __init__(self, max_iterations: int = 10) -> None:
+        self.max_iterations = max_iterations
 
     async def plan(self, state: dict[str, Any]) -> list[Action]:
         """Plan next action in ReAct loop.

routekitai/core/runtime.py

@@ -543,6 +543,14 @@ class Runtime(BaseModel):
                 output_message = Message.assistant(final_response.content)
                 messages.append(output_message)
 
+        # If final output has no content (e.g. model returned empty after tool use),
+        # use the last assistant message that had content so the run result is useful.
+        if not (output_message.content or "").strip() and messages:
+            for msg in reversed(messages):
+                if msg.role == MessageRole.ASSISTANT and (msg.content or "").strip():
+                    output_message = msg
+                    break
+
         # Import here to avoid circular import
         from routekitai.core.agent import RunResult
 

routekitai/providers/__init__.py

@@ -1,9 +1,11 @@
 """Model providers for RouteKit."""
 
+from routekitai.providers.anthropic import AnthropicModel
 from routekitai.providers.local import FakeModel
 from routekitai.providers.openai import OpenAIChatModel
 
 __all__ = [
+    "AnthropicModel",
     "OpenAIChatModel",
     "FakeModel",
 ]

routekitai/providers/anthropic.py

@@ -75,7 +75,11 @@ class AnthropicModel(Model):
         return self._client
 
     def _message_to_anthropic(self, message: Message) -> dict[str, Any]:
-        """Convert routkitai Message to Anthropic format."""
+        """Convert routkitai Message to Anthropic format.
+
+        Anthropic requires all messages to have non-empty content except the
+        optional final assistant message. We ensure content is never empty.
+        """
         role_map = {
             MessageRole.SYSTEM: "system",
             MessageRole.USER: "user",
@@ -84,13 +88,15 @@ class AnthropicModel(Model):
         # Anthropic doesn't support tool role messages directly
         if message.role == MessageRole.TOOL:
             # Convert tool messages to user messages with tool result
-            return {
-                "role": "user",
-                "content": f"Tool result: {message.content}",
-            }
+            content = (
+                f"Tool result: {message.content}" if message.content else "Tool result: (no output)"
+            )
+            return {"role": "user", "content": content}
+        # API rejects empty or whitespace-only content; use a non-whitespace placeholder
+        content = message.content if (message.content and message.content.strip()) else "(no text)"
         return {
             "role": role_map.get(message.role, "user"),
-            "content": message.content,
+            "content": content,
         }
 
     def _tools_to_anthropic(self, tools: list[Tool]) -> list[dict[str, Any]]:
@@ -208,9 +214,19 @@ class AnthropicModel(Model):
             )
 
         except httpx.HTTPStatusError as e:
-            raise ModelError(
-                f"Anthropic API error: {e.response.status_code} - {e.response.text}"
-            ) from e
+            msg = f"Anthropic API error: {e.response.status_code}"
+            try:
+                body = e.response.json()
+                err = body.get("error") or {}
+                if isinstance(err, dict) and err.get("message"):
+                    msg = f"{msg} - {err['message']}"
+                else:
+                    msg = f"{msg} - {e.response.text}"
+            except Exception:
+                msg = f"{msg} - {e.response.text}"
+            if e.response.status_code == 404 and "model" in msg.lower():
+                msg += " Use a model ID from https://docs.anthropic.com/en/api/models or set ANTHROPIC_MODEL."
+            raise ModelError(msg) from e
         except Exception as e:
             raise ModelError(f"Failed to call Anthropic API: {e}") from e
 

{routekitai-0.2.0.dist-info → routekitai-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: RouteKitAI
-Version: 0.2.0
+Version: 0.2.1
 Summary: An agent development + orchestration framework
 Author: Mohamed Ghassen Brahim
 License: MIT
@@ -41,6 +41,9 @@ Requires-Dist: sentence-transformers>=2.2.0; extra == "optional"
 Requires-Dist: faiss-cpu>=1.7.4; extra == "optional"
 Requires-Dist: openai>=1.0.0; extra == "optional"
 Requires-Dist: nest-asyncio>=1.5.0; extra == "optional"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5.0; extra == "docs"
+Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
 Dynamic: license-file
 
 # RouteKitAI
@@ -60,6 +63,8 @@ Dynamic: license-file
 
 ---
 
+> **⚠️ Early stage**: RouteKitAI is still in very early development. APIs may change, and some features are experimental. Use with caution in production.
+
 RouteKitAI is a Python framework for building AI agents with **graph-based orchestration**, **built-in tracing**, and **deterministic replay**. Unlike other frameworks, RouteKitAI treats observability and testability as first-class features from day one.
 
 ## ✨ Features
@@ -202,6 +207,7 @@ asyncio.run(main())
 Check out the [`examples/`](examples/) directory for complete examples:
 
 - **[Basic Agent](examples/basic.py)** / **[Hello RouteKit](examples/hello_routekit.py)**: Simple agent with tools
+- **[Real agent with Anthropic](examples/anthropic_agent.py)**: Live Claude agent with tool use (requires `ANTHROPIC_API_KEY`)
 - **[Graph Orchestration](examples/graph_agent.py)** / **[Graph Policy](examples/graph_policy.py)**: Multi-agent workflows
 - **[Supervisor Pattern](examples/supervisor_agent.py)** / **[Supervisor Policy](examples/supervisor_policy.py)**: Supervisor delegating to sub-agents
 - **[ReAct / Plan–Execute / Function Calling](examples/react_policy.py)**, **[Plan–Execute](examples/plan_execute_policy.py)**, **[Function Calling](examples/function_calling_policy.py)**: Policy examples
@@ -305,8 +311,29 @@ Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) and:
 
 ## 📋 Requirements
 
-- Python 3.11 or higher
-- Pydantic 2.0+
+**Core (always installed):**
+
+- Python 3.11+
+- [Pydantic](https://docs.pydantic.dev/) 2.x
+- [NumPy](https://numpy.org/) 1.24+
+- [httpx](https://www.python-httpx.org/) 0.24+
+
+**Optional extras:**
+
+| Extra | Purpose |
+|-------|---------|
+| `[dev]` | CLI, tests, linting, type checking (pytest, mypy, ruff, rich, typer, safety, bandit) |
+| `[ui]` | Web UI for traces: `routekitai serve` (FastAPI, Uvicorn) |
+| `[optional]` | Vector memory, OpenAI adapter (sentence-transformers, faiss, openai, nest-asyncio) |
+| `[docs]` | Build documentation locally (MkDocs, MkDocs Material) |
+
+Examples:
+
+```bash
+pip install "RouteKitAI[dev]"       # development + CLI
+pip install "RouteKitAI[dev,ui]"    # + trace web UI
+pip install "RouteKitAI[docs]"      # build docs: mkdocs build / mkdocs serve
+```
 
 ## 📄 License
 

{routekitai-0.2.0.dist-info → routekitai-0.2.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-routekitai/__init__.py,sha256=tXiazo0NHxFeWcHWsKLCoDMn_fFBH_RQsF-vGeqTWpo,1091
+routekitai/__init__.py,sha256=155KUL2u8F-wn5wV7oT4bwzpJ84l2OWhmsU-hk-MM3A,1091
 routekitai/message.py,sha256=owTgRvHctqquWROng2w06c6sMrarKlB6avxHoPhuC3k,830
 routekitai/model.py,sha256=FfGla6Hep-L1bz-rC89leGdbtQed433FZ1yz4eF0wko,1357
 routekitai/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -19,10 +19,10 @@ routekitai/core/hooks.py,sha256=lnp5tK_amFDUbkYWxvWnIDwQ2uI4em2Go0KLb1QtD7c,5644
 routekitai/core/memory.py,sha256=szDTIr3tCgM4aeFO19tOlGj6a8lLPBHTv4KByeUxC2k,1429
 routekitai/core/message.py,sha256=-nc3rPahQFADkeoA_Ipaq4ELPI14e23JAPIskIvM7js,3471
 routekitai/core/model.py,sha256=vghe66IRXmRO5vNtxQl_L2aVrODE_5Fyj0g_BLCaSMQ,3158
-routekitai/core/policies.py,sha256=bSC9v7clYZLxkHsiAgneCGEQfXs7Jzvpd_rK8lFQutE,13872
+routekitai/core/policies.py,sha256=uNkeArb__aJdNCmdwVa8gWDZVTbSxW-MJHFgBInQFUw,13946
 routekitai/core/policy.py,sha256=CscLNg2Z4U_XV-xC0mf7QlZN-QCJ3zewSz8uPE5NIR8,2814
 routekitai/core/policy_adapter.py,sha256=GeVVQBfd4Bo3Ijzgcq8fdn1CRtC9XOVwb7f4SkfylYY,5887
-routekitai/core/runtime.py,sha256=rgSD88vxrLV0ZhhuF-q8jsuQprjAqm1z3iS-_lre0zk,61402
+routekitai/core/runtime.py,sha256=vOngcUlpJWq2t1ZgdJqQV2gChmlZBQtg9or6Frg3Bkk,61839
 routekitai/core/tool.py,sha256=96zHRidFV8NX9x8fWvbNyT3Up2UL-0BjaNLBl_P79_o,4959
 routekitai/core/tools.py,sha256=9jye7xa1NcJnSARRarRAIMsbF6gmyI4DlyCCv7HuRYM,5215
 routekitai/evals/__init__.py,sha256=9J7kySk46qCOApOlIMvOsPSjc3_NzvxCSuZ8-OejBNU,336
@@ -47,8 +47,8 @@ routekitai/observability/exporters/__init__.py,sha256=g_YIeoJ_YWANEtETQgF7zEBNtW
 routekitai/observability/exporters/base.py,sha256=zhkCem3xXqKmrB38QsFaM1HAbxECPOyLoPuO5Jbd-nA,672
 routekitai/observability/exporters/jsonl.py,sha256=wBHgzfvBSksQQ_WLYXnPF9OH6_a7ldgbTlTUzTs0U7E,2621
 routekitai/observability/exporters/otel.py,sha256=Cl25rA1robwJVaOtoHRT2W3VTGvY3ibJ0eoqXQwbsb8,4249
-routekitai/providers/__init__.py,sha256=jE24VQsKG5nloM6xjdBazvptblaKRBTusTc42EW5km4,197
-routekitai/providers/anthropic.py,sha256=_Zo4tN4WQ6jZcmMD7WP4izhka4yT8qr0cnrSfApuQUM,7687
+routekitai/providers/__init__.py,sha256=-43vXwysU7NNuluD2QcmNFNmlfKMgOq_5uCnWm6ptyY,277
+routekitai/providers/anthropic.py,sha256=v8aSHz4zvCYW958tV-VjGN5joya8U4LCtSUJ86pNBfs,8634
 routekitai/providers/azure_openai.py,sha256=2iTvaLFKTseKy41E4D1EOT4NvwsxK5BSo5G0xaJjd7Y,8312
 routekitai/providers/local.py,sha256=Ii959ycdAOhnUucAlaBPCNP5YOxgFgRmuCbu_XibQwY,7693
 routekitai/providers/openai.py,sha256=ImTGXOiHyNtXUNF2tzBF4Dkv8r_aPrmQDUH6Cu7-zi4,12641
@@ -56,9 +56,9 @@ routekitai/sandbox/__init__.py,sha256=erkRO6xnq7NcOmv_rV444IRJl0WmhRWoVX1Sx8XiqX
 routekitai/sandbox/filesystem.py,sha256=5bLMhrutoJQVfOM49v1L1ykVpjFee50dERdyY4VaiGM,4744
 routekitai/sandbox/network.py,sha256=cFK--kZ88irTREWgTWhXDBDvynzq9XdHjFn_jGcF3HI,4668
 routekitai/sandbox/permissions.py,sha256=5rGeF_4JcpetrsVYZuAw-S-rV5vsic1OSJAh0we-uDs,2094
-routekitai-0.2.0.dist-info/licenses/LICENSE,sha256=TftL8ryIHKESApEmr5TBlRg5mengWfrzzjlr7nz46iE,1079
-routekitai-0.2.0.dist-info/METADATA,sha256=XS91zXumQ49sZuoJHxXX4kRu9FK5CC-5mRe0D671D8g,10592
-routekitai-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-routekitai-0.2.0.dist-info/entry_points.txt,sha256=pHUdSYPaXtmUY5LmHWKcgh2dR-t0DRrgUZ3AO0Pk9L0,56
-routekitai-0.2.0.dist-info/top_level.txt,sha256=lbYswJspf7-baehrsDZboTTxhrabTTPf4mGYC_jXKaY,11
-routekitai-0.2.0.dist-info/RECORD,,
+routekitai-0.2.1.dist-info/licenses/LICENSE,sha256=TftL8ryIHKESApEmr5TBlRg5mengWfrzzjlr7nz46iE,1079
+routekitai-0.2.1.dist-info/METADATA,sha256=goTgbouS7za77-MZnmXGGZWc4bSh_tmAIbzATdBbi24,11747
+routekitai-0.2.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+routekitai-0.2.1.dist-info/entry_points.txt,sha256=pHUdSYPaXtmUY5LmHWKcgh2dR-t0DRrgUZ3AO0Pk9L0,56
+routekitai-0.2.1.dist-info/top_level.txt,sha256=lbYswJspf7-baehrsDZboTTxhrabTTPf4mGYC_jXKaY,11
+routekitai-0.2.1.dist-info/RECORD,,