AbstractAgent 0.1.0__tar.gz → 0.3.0__tar.gz

{abstractagent-0.1.0 → abstractagent-0.3.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.3.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: abstractagent
+Version: 0.3.0
+Summary: Agent implementations using AbstractRuntime and AbstractCore
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: abstractcore[tools]
+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
+- **Host UX in AbstractCode**: the interactive terminal shell lives in **AbstractCode**; AbstractAgent stays focused on agent patterns/workflows
+- **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")
+```
+
+## Interactive Shell (AbstractCode)
+
+```bash
+# The interactive REPL moved to AbstractCode (host UX).
+abstractcode --agent react --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
+
+- Default tool callables are re-exported from AbstractCore in `abstractagent.tools` (file ops, web tools, `execute_command`), plus:
+  - `execute_python(code, timeout_s=...)`
+  - `self_improve(suggestion, ...)`
+- The agent also exposes schema-only built-ins (`ask_user`, `recall_memory`, `inspect_vars`, `remember`, `compact_memory`) which are translated into **Runtime effects** by the workflow adapters (durable; no callable persistence).

abstractagent-0.3.0/README.md

@@ -0,0 +1,120 @@
+# AbstractAgent
+
+Agent implementations using AbstractRuntime and AbstractCore.
+
+## Features
+
+- **ReAct Agent**: Reason-Act-Observe loop with tool calling
+- **Host UX in AbstractCode**: the interactive terminal shell lives in **AbstractCode**; AbstractAgent stays focused on agent patterns/workflows
+- **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")
+```
+
+## Interactive Shell (AbstractCode)
+
+```bash
+# The interactive REPL moved to AbstractCode (host UX).
+abstractcode --agent react --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
+
+- Default tool callables are re-exported from AbstractCore in `abstractagent.tools` (file ops, web tools, `execute_command`), plus:
+  - `execute_python(code, timeout_s=...)`
+  - `self_improve(suggestion, ...)`
+- The agent also exposes schema-only built-ins (`ask_user`, `recall_memory`, `inspect_vars`, `remember`, `compact_memory`) which are translated into **Runtime effects** by the workflow adapters (durable; no callable persistence).

abstractagent-0.3.0/pyproject.toml

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

abstractagent-0.3.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.3.0/src/abstractagent/adapters/__init__.py

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