abstractagent 0.2.0__tar.gz → 0.3.1__tar.gz

abstractagent-0.3.1/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: abstractagent
+Version: 0.3.1
+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 patterns (ReAct / CodeAct / MemAct) built on **AbstractRuntime** (durable execution) and **AbstractCore** (tools + LLM integration).
+
+Start here: [`docs/getting-started.md`](docs/getting-started.md) (then [`docs/README.md`](docs/README.md) for the full index)
+
+## Documentation
+
+- Getting started: [`docs/getting-started.md`](docs/getting-started.md)
+- API reference: [`docs/api.md`](docs/api.md)
+- FAQ / troubleshooting: [`docs/faq.md`](docs/faq.md)
+- Architecture (diagrams): [`docs/architecture.md`](docs/architecture.md)
+- Changelog: [`CHANGELOG.md`](CHANGELOG.md)
+- Contributing: [`CONTRIBUTING.md`](CONTRIBUTING.md)
+- Security: [`SECURITY.md`](SECURITY.md)
+- Acknowledgements: [`ACKNOWLEDMENTS.md`](ACKNOWLEDMENTS.md)
+
+## What you get
+
+- **ReAct**: tool-first Reason → Act → Observe loop
+- **CodeAct**: executes Python (tool call or fenced ` ```python``` ` blocks)
+- **MemAct**: memory-enhanced agent using runtime-owned Active Memory
+- **Durable runs**: pause/resume via `run_id` + runtime stores
+- **Tool control**: explicit tool bundles + per-run allowlists
+- **Observability**: durable ledger of LLM calls, tool calls, and waits
+
+## Installation
+
+From source (development):
+
+```bash
+pip install -e .
+```
+
+With dev dependencies:
+
+```bash
+pip install -e ".[dev]"
+```
+
+From PyPI:
+
+```bash
+pip install abstractagent
+```
+
+Note: the repository may be ahead of the latest published PyPI release. To verify what you installed:
+
+```bash
+python -c "import importlib.metadata as md; print(md.version('abstractagent'))"
+```
+
+## Quick start (ReAct)
+
+```python
+from abstractagent import create_react_agent
+
+agent = create_react_agent(provider="ollama", model="qwen3:1.7b-q4_K_M")
+agent.start("List the files in the current directory")
+state = agent.run_to_completion()
+print(state.output["answer"])
+```
+
+## Persistence (resume across restarts)
+
+By default, the factory helpers use an in-memory runtime store. For resume across process restarts,
+pass a persistent `RunStore`/`LedgerStore` (example below uses JSON files).
+
+```python
+from abstractagent import create_react_agent
+from abstractruntime.storage.json_files import JsonFileRunStore, JsonlLedgerStore
+
+run_store = JsonFileRunStore(".runs")
+ledger_store = JsonlLedgerStore(".runs")
+
+agent = create_react_agent(run_store=run_store, ledger_store=ledger_store)
+agent.start("Long running task")
+agent.save_state("agent_state.json")
+
+# ... later / after restart ...
+
+agent2 = create_react_agent(run_store=run_store, ledger_store=ledger_store)
+agent2.load_state("agent_state.json")
+state = agent2.run_to_completion()
+print(state.output["answer"])
+```
+
+More details: [`docs/persistence.md`](docs/persistence.md)
+
+## CLI
+
+This repository still installs a `react-agent` entrypoint, but it is **deprecated** and only prints a migration hint
+(see `src/abstractagent/repl.py` and `pyproject.toml`).
+
+Interactive UX lives in **AbstractCode**.
+
+## License
+
+MIT (see `LICENSE`).

abstractagent-0.3.1/README.md

@@ -0,0 +1,99 @@
+# AbstractAgent
+
+Agent patterns (ReAct / CodeAct / MemAct) built on **AbstractRuntime** (durable execution) and **AbstractCore** (tools + LLM integration).
+
+Start here: [`docs/getting-started.md`](docs/getting-started.md) (then [`docs/README.md`](docs/README.md) for the full index)
+
+## Documentation
+
+- Getting started: [`docs/getting-started.md`](docs/getting-started.md)
+- API reference: [`docs/api.md`](docs/api.md)
+- FAQ / troubleshooting: [`docs/faq.md`](docs/faq.md)
+- Architecture (diagrams): [`docs/architecture.md`](docs/architecture.md)
+- Changelog: [`CHANGELOG.md`](CHANGELOG.md)
+- Contributing: [`CONTRIBUTING.md`](CONTRIBUTING.md)
+- Security: [`SECURITY.md`](SECURITY.md)
+- Acknowledgements: [`ACKNOWLEDMENTS.md`](ACKNOWLEDMENTS.md)
+
+## What you get
+
+- **ReAct**: tool-first Reason → Act → Observe loop
+- **CodeAct**: executes Python (tool call or fenced ` ```python``` ` blocks)
+- **MemAct**: memory-enhanced agent using runtime-owned Active Memory
+- **Durable runs**: pause/resume via `run_id` + runtime stores
+- **Tool control**: explicit tool bundles + per-run allowlists
+- **Observability**: durable ledger of LLM calls, tool calls, and waits
+
+## Installation
+
+From source (development):
+
+```bash
+pip install -e .
+```
+
+With dev dependencies:
+
+```bash
+pip install -e ".[dev]"
+```
+
+From PyPI:
+
+```bash
+pip install abstractagent
+```
+
+Note: the repository may be ahead of the latest published PyPI release. To verify what you installed:
+
+```bash
+python -c "import importlib.metadata as md; print(md.version('abstractagent'))"
+```
+
+## Quick start (ReAct)
+
+```python
+from abstractagent import create_react_agent
+
+agent = create_react_agent(provider="ollama", model="qwen3:1.7b-q4_K_M")
+agent.start("List the files in the current directory")
+state = agent.run_to_completion()
+print(state.output["answer"])
+```
+
+## Persistence (resume across restarts)
+
+By default, the factory helpers use an in-memory runtime store. For resume across process restarts,
+pass a persistent `RunStore`/`LedgerStore` (example below uses JSON files).
+
+```python
+from abstractagent import create_react_agent
+from abstractruntime.storage.json_files import JsonFileRunStore, JsonlLedgerStore
+
+run_store = JsonFileRunStore(".runs")
+ledger_store = JsonlLedgerStore(".runs")
+
+agent = create_react_agent(run_store=run_store, ledger_store=ledger_store)
+agent.start("Long running task")
+agent.save_state("agent_state.json")
+
+# ... later / after restart ...
+
+agent2 = create_react_agent(run_store=run_store, ledger_store=ledger_store)
+agent2.load_state("agent_state.json")
+state = agent2.run_to_completion()
+print(state.output["answer"])
+```
+
+More details: [`docs/persistence.md`](docs/persistence.md)
+
+## CLI
+
+This repository still installs a `react-agent` entrypoint, but it is **deprecated** and only prints a migration hint
+(see `src/abstractagent/repl.py` and `pyproject.toml`).
+
+Interactive UX lives in **AbstractCode**.
+
+## License
+
+MIT (see `LICENSE`).

{abstractagent-0.2.0 → abstractagent-0.3.1}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "abstractagent"
-version = "0.2.0"
+version = "0.3.1"
 description = "Agent implementations using AbstractRuntime and AbstractCore"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "abstractcore",
+    "abstractcore[tools]",
     "abstractruntime",
 ]
 
@@ -23,3 +23,10 @@ where = ["src"]
 
 [project.scripts]
 react-agent = "abstractagent.repl:main"
+
+[tool.pytest.ini_options]
+markers = [
+    "basic: Level A (contract/unit) tests",
+    "integration: Level B (integration/local) tests",
+    "e2e: Level C (end-to-end/real infra) tests (opt-in)",
+]

{abstractagent-0.2.0 → abstractagent-0.3.1}/src/abstractagent/adapters/__init__.py

@@ -2,5 +2,6 @@
 
 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"]
+__all__ = ["create_react_workflow", "create_codeact_workflow", "create_memact_workflow"]