AbstractAgent 0.1.0__tar.gz → 0.2.0__tar.gz

{abstractagent-0.1.0 → abstractagent-0.2.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 AbstractAgent Team
+Copyright (c) 2025 Laurent-Philippe Albou
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -19,3 +19,7 @@ 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.
+
+
+
+

abstractagent-0.2.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: abstractagent
+Version: 0.2.0
+Summary: Agent implementations using AbstractRuntime and AbstractCore
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: abstractcore
+Requires-Dist: abstractruntime
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# AbstractAgent
+
+Agent implementations using AbstractRuntime and AbstractCore.
+
+## Features
+
+- **ReAct Agent**: Reason-Act-Observe loop with tool calling
+- **Async REPL**: Interactive agent with real-time step visibility
+- **Pause/Resume**: Durable agent state with interrupt/resume capability
+- **Ask User**: Agent can ask questions with multiple choice + free text
+- **Ledger Recording**: All tool calls recorded for auditability
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+### Simple (Factory)
+
+```python
+from abstractagent import create_react_agent
+
+# One-liner agent creation
+agent = create_react_agent()
+agent.start("List the files in the current directory")
+state = agent.run_to_completion()
+print(state.output["answer"])
+```
+
+### With Custom Tools
+
+```python
+from abstractagent import create_react_agent
+from abstractcore.tools import tool
+
+@tool(name="my_tool", description="My custom tool")
+def my_tool(query: str) -> str:
+    """My custom tool."""
+    return f"Result for {query}"
+
+agent = create_react_agent(tools=[my_tool])
+```
+
+### Full Control
+
+```python
+from abstractruntime.integrations.abstractcore import create_local_runtime
+from abstractagent import ReactAgent, list_files, read_file
+
+# Create runtime
+runtime = create_local_runtime(
+    provider="ollama",
+    model="qwen3:4b-instruct-2507-q4_K_M",
+)
+
+# Create agent with specific tools
+agent = ReactAgent(
+    runtime=runtime,
+    tools=[list_files, read_file],
+)
+
+agent.start("List the files in the current directory")
+state = agent.run_to_completion()
+print(state.output["answer"])
+```
+
+## State Persistence
+
+Resume agents across process restarts:
+
+```python
+agent = create_react_agent()
+agent.start("Long running task")
+
+# Save state before exit
+agent.save_state("agent_state.json")
+
+# ... process restarts ...
+
+# Load and resume
+agent = create_react_agent()
+agent.load_state("agent_state.json")
+state = agent.run_to_completion()
+
+# Cleanup
+agent.clear_state("agent_state.json")
+```
+
+## REPL Usage
+
+```bash
+# Start the ReAct agent REPL
+python -m abstractagent.repl --provider ollama --model qwen3:4b-instruct-2507-q4_K_M
+```
+
+## Architecture
+
+```
+AbstractAgent
+     │
+     ├── Uses AbstractRuntime for durable execution
+     │   - Workflows survive crashes
+     │   - Pause/resume capability
+     │   - Ledger tracks all actions (LLM calls, tool calls)
+     │
+     └── Uses AbstractCore for LLM/tools
+         - Provider-agnostic LLM calls
+         - Tool registration and execution
+         - Tool call parsing for all model architectures
+```
+
+## Available Tools
+
+- `list_files(path)` - List files and directories
+- `read_file(path)` - Read file contents
+- `search_files(pattern, path)` - Search for files matching a glob pattern
+- `execute_command(command)` - Execute a shell command (with safety restrictions)
+- `ask_user(question, choices)` - Ask the user a question (built-in)

abstractagent-0.2.0/README.md

@@ -0,0 +1,121 @@
+# AbstractAgent
+
+Agent implementations using AbstractRuntime and AbstractCore.
+
+## Features
+
+- **ReAct Agent**: Reason-Act-Observe loop with tool calling
+- **Async REPL**: Interactive agent with real-time step visibility
+- **Pause/Resume**: Durable agent state with interrupt/resume capability
+- **Ask User**: Agent can ask questions with multiple choice + free text
+- **Ledger Recording**: All tool calls recorded for auditability
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+### Simple (Factory)
+
+```python
+from abstractagent import create_react_agent
+
+# One-liner agent creation
+agent = create_react_agent()
+agent.start("List the files in the current directory")
+state = agent.run_to_completion()
+print(state.output["answer"])
+```
+
+### With Custom Tools
+
+```python
+from abstractagent import create_react_agent
+from abstractcore.tools import tool
+
+@tool(name="my_tool", description="My custom tool")
+def my_tool(query: str) -> str:
+    """My custom tool."""
+    return f"Result for {query}"
+
+agent = create_react_agent(tools=[my_tool])
+```
+
+### Full Control
+
+```python
+from abstractruntime.integrations.abstractcore import create_local_runtime
+from abstractagent import ReactAgent, list_files, read_file
+
+# Create runtime
+runtime = create_local_runtime(
+    provider="ollama",
+    model="qwen3:4b-instruct-2507-q4_K_M",
+)
+
+# Create agent with specific tools
+agent = ReactAgent(
+    runtime=runtime,
+    tools=[list_files, read_file],
+)
+
+agent.start("List the files in the current directory")
+state = agent.run_to_completion()
+print(state.output["answer"])
+```
+
+## State Persistence
+
+Resume agents across process restarts:
+
+```python
+agent = create_react_agent()
+agent.start("Long running task")
+
+# Save state before exit
+agent.save_state("agent_state.json")
+
+# ... process restarts ...
+
+# Load and resume
+agent = create_react_agent()
+agent.load_state("agent_state.json")
+state = agent.run_to_completion()
+
+# Cleanup
+agent.clear_state("agent_state.json")
+```
+
+## REPL Usage
+
+```bash
+# Start the ReAct agent REPL
+python -m abstractagent.repl --provider ollama --model qwen3:4b-instruct-2507-q4_K_M
+```
+
+## Architecture
+
+```
+AbstractAgent
+     │
+     ├── Uses AbstractRuntime for durable execution
+     │   - Workflows survive crashes
+     │   - Pause/resume capability
+     │   - Ledger tracks all actions (LLM calls, tool calls)
+     │
+     └── Uses AbstractCore for LLM/tools
+         - Provider-agnostic LLM calls
+         - Tool registration and execution
+         - Tool call parsing for all model architectures
+```
+
+## Available Tools
+
+- `list_files(path)` - List files and directories
+- `read_file(path)` - Read file contents
+- `search_files(pattern, path)` - Search for files matching a glob pattern
+- `execute_command(command)` - Execute a shell command (with safety restrictions)
+- `ask_user(question, choices)` - Ask the user a question (built-in)

abstractagent-0.2.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "abstractagent"
+version = "0.2.0"
+description = "Agent implementations using AbstractRuntime and AbstractCore"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "abstractcore",
+    "abstractruntime",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[project.scripts]
+react-agent = "abstractagent.repl:main"

abstractagent-0.2.0/src/abstractagent/__init__.py

@@ -0,0 +1,49 @@
+"""AbstractAgent - Agent implementations using AbstractRuntime and AbstractCore."""
+
+from .agents import (
+    BaseAgent,
+    ReactAgent,
+    create_react_workflow,
+    create_react_agent,
+    CodeActAgent,
+    create_codeact_workflow,
+    create_codeact_agent,
+)
+from .tools import (
+    ALL_TOOLS,
+    list_files,
+    read_file,
+    search_files,
+    execute_command,
+    write_file,
+    edit_file,
+    web_search,
+    fetch_url,
+    execute_python,
+    self_improve,
+)
+
+__all__ = [
+    # Base class for custom agents
+    "BaseAgent",
+    # ReAct agent
+    "ReactAgent",
+    "create_react_workflow",
+    "create_react_agent",
+    # CodeAct agent
+    "CodeActAgent",
+    "create_codeact_workflow",
+    "create_codeact_agent",
+    # Tools
+    "ALL_TOOLS",
+    "list_files",
+    "read_file",
+    "search_files",
+    "execute_command",
+    "write_file",
+    "edit_file",
+    "web_search",
+    "fetch_url",
+    "execute_python",
+    "self_improve",
+]

abstractagent-0.2.0/src/abstractagent/adapters/__init__.py

@@ -0,0 +1,6 @@
+"""Runtime adapters for agent logic."""
+
+from .codeact_runtime import create_codeact_workflow
+from .react_runtime import create_react_workflow
+
+__all__ = ["create_react_workflow", "create_codeact_workflow"]