aloop 0.1.1__py3-none-any.whl

aloop-0.1.1.dist-info/METADATA

@@ -0,0 +1,252 @@
+Metadata-Version: 2.4
+Name: aloop
+Version: 0.1.1
+Summary: General AI Agent System
+Author-email: luohaha <luoyixin6688@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/luohaha/aloop
+Project-URL: Documentation, https://github.com/luohaha/aloop#readme
+Project-URL: Repository, https://github.com/luohaha/aloop
+Project-URL: Issues, https://github.com/luohaha/aloop/issues
+Keywords: ai,agent,llm,claude,gpt,gemini,loop,planning
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ddgs>=1.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: prompt_toolkit>=3.0.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: trafilatura>=2.0.0
+Requires-Dist: lxml>=5.0.0
+Requires-Dist: aiofiles>=24.1.0
+Requires-Dist: litellm>=1.30.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: tiktoken>=0.5.0
+Requires-Dist: tenacity>=8.2.0
+Requires-Dist: tree-sitter<0.22.0,>=0.21.0
+Requires-Dist: tree-sitter-languages<1.11.0,>=1.8.0
+Requires-Dist: croniter>=1.3.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: ruff>=0.6.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Requires-Dist: types-aiofiles>=25.1.0; extra == "dev"
+Requires-Dist: types-croniter>=1.3.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+<picture>
+  <img alt="ALOOP" src="docs/assets/logo.svg" width="440">
+</picture>
+
+**One loop is all you need.**
+
+aloop is an AI agent built on a single, unified loop. Planning, parallel sub-agents,
+self-verification — everything folds into the same loop, chosen autonomously by the
+agent itself, not by a hardcoded workflow. Simple architecture, emergent capability.
+
+
+</div>
+
+## Installation
+
+Prerequisites: Python 3.12+.
+
+```bash
+pip install aloop
+```
+
+Or install from source (for development):
+
+```bash
+git clone https://github.com/luohaha/aloop.git
+cd aloop
+./scripts/bootstrap.sh   # requires uv
+```
+
+## Quick Start
+
+### 1. Configure Models
+
+On first run, `~/.aloop/models.yaml` is created with a template. Edit it to add your provider and API key:
+
+```yaml
+models:
+  openai/gpt-4o:
+    api_key: sk-...
+
+  anthropic/claude-3-5-sonnet-20241022:
+    api_key: sk-ant-...
+
+  ollama/llama2:
+    api_base: http://localhost:11434
+
+default: openai/gpt-4o
+```
+
+See [LiteLLM Providers](https://docs.litellm.ai/docs/providers) for the full list.
+
+### 2. Run
+
+```bash
+# Interactive mode
+aloop
+
+# Single task (returns raw result)
+aloop --task "Calculate 123 * 456"
+
+# Resume last session
+aloop --resume
+
+# Resume specific session (ID prefix)
+aloop --resume a1b2c3d4
+```
+
+## CLI Reference
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--task TEXT` | `-t` | Run a single task and exit |
+| `--model ID` | `-m` | LiteLLM model ID to use |
+| `--resume [ID]` | `-r` | Resume a session (`latest` if no ID given) |
+| `--verbose` | `-v` | Enable verbose logging to `~/.aloop/logs/` |
+
+## Interactive Commands
+
+### Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show help |
+| `/clear` | Clear conversation and start fresh |
+| `/stats` | Show memory and token usage statistics |
+| `/resume [id]` | List or resume a previous session |
+| `/model` | Pick a model (arrow keys + Enter) |
+| `/model edit` | Open `~/.aloop/models.yaml` in editor (auto-reload on save) |
+| `/theme` | Toggle dark/light theme |
+| `/verbose` | Toggle thinking display |
+| `/compact` | Toggle compact output |
+| `/exit` | Exit (also `/quit`) |
+
+### Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `/` | Command autocomplete |
+| `Ctrl+C` | Cancel current operation |
+| `Ctrl+L` | Clear screen |
+| `Ctrl+T` | Toggle thinking display |
+| `Ctrl+S` | Show quick stats |
+| Up/Down | Navigate command history |
+
+## How It Works
+
+**Agent loop**: The agent follows a Think-Act-Observe cycle. It reasons about the task, selects a tool, observes the result, and repeats until it has an answer. Planning, sub-agent dispatch, and tool use all happen inside this single loop.
+
+**Ralph verification**: For single tasks (`--task`), an outer loop verifies the agent's answer against the original task. If incomplete, feedback is injected and the agent loop re-enters. Configurable via `RALPH_LOOP_MAX_ITERATIONS` (default: 3).
+
+**Memory compression**: When context grows past a token threshold, older messages are compressed via LLM summarization. Recent messages are kept at full fidelity. Strategies: `sliding_window` (default), `selective`, `deletion`.
+
+**Session persistence**: Conversations are saved as YAML files under `~/.aloop/sessions/`. Resume with `--resume` or `/resume`.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `read_file` | Read file contents |
+| `write_file` | Write content to a file |
+| `search_files` | Search for files by name |
+| `edit_file` | Exact string replacement in files |
+| `smart_edit` | LLM-assisted file editing |
+| `glob_files` | Glob pattern file matching |
+| `grep_content` | Regex search in file contents |
+| `code_navigator` | AST-based code navigation (tree-sitter) |
+| `calculate` | Evaluate expressions / run Python code |
+| `shell` | Execute shell commands |
+| `shell_task_status` | Check background shell task status |
+| `web_search` | Web search (DuckDuckGo) |
+| `web_fetch` | Fetch and extract web page content |
+| `explore_context` | Explore project structure and context |
+| `parallel_execute` | Run multiple tool calls in parallel |
+| `notify` | Send email notifications (Resend) |
+| `manage_todo_list` | Manage a task/todo list |
+
+## Project Structure
+
+```
+aloop/
+├── main.py                 # Entry point (argparse)
+├── cli.py                  # CLI wrapper (`aloop` entry point)
+├── interactive.py          # Interactive session, model setup, TUI
+├── config.py               # Runtime config (~/.aloop/config)
+├── agent/
+│   ├── base.py             # BaseAgent (ReAct + Ralph loops)
+│   ├── agent.py            # LoopAgent
+│   ├── verification.py     # LLMVerifier for Ralph loop
+│   ├── context.py          # Context injection (cwd, platform, date)
+│   ├── tool_executor.py    # Tool execution engine
+│   └── todo.py             # Todo list data structure
+├── llm/
+│   ├── litellm_adapter.py  # LiteLLM adapter (100+ providers)
+│   ├── model_manager.py    # Model config from ~/.aloop/models.yaml
+│   ├── retry.py            # Retry with exponential backoff
+│   └── message_types.py    # LLMMessage, LLMResponse, ToolCall
+├── memory/
+│   ├── manager.py          # Memory orchestrator + persistence
+│   ├── compressor.py       # LLM-driven compression
+│   ├── short_term.py       # Short-term memory (sliding window)
+│   ├── token_tracker.py    # Token counting + cost tracking
+│   ├── types.py            # Core data structures
+│   └── store/
+│       └── yaml_file_memory_store.py  # YAML session persistence
+├── tools/                  # 18 tool implementations
+├── utils/
+│   ├── tui/                # TUI components (input, themes, status bar)
+│   ├── logger.py           # Logging setup
+│   └── model_pricing.py    # Model pricing data
+├── docs/                   # Documentation
+├── test/                   # Tests
+├── scripts/                # Dev scripts (bootstrap.sh, dev.sh)
+└── rfc/                    # RFC design documents
+```
+
+## Configuration
+
+Runtime settings live in `~/.aloop/config` (auto-created). Key settings:
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `MAX_ITERATIONS` | `1000` | Maximum agent loop iterations |
+| `TOOL_TIMEOUT` | `600` | Tool execution timeout (seconds) |
+| `RALPH_LOOP_MAX_ITERATIONS` | `3` | Max verification attempts |
+| `MEMORY_ENABLED` | `true` | Enable memory management |
+| `MEMORY_COMPRESSION_THRESHOLD` | `60000` | Token threshold for compression |
+| `MEMORY_SHORT_TERM_SIZE` | `100` | Messages kept at full fidelity |
+| `RETRY_MAX_ATTEMPTS` | `3` | Rate-limit retry attempts |
+
+See [Configuration Guide](docs/configuration.md) for all settings.
+
+## Documentation
+
+- [Configuration](docs/configuration.md) -- model setup, runtime settings, custom endpoints
+- [Examples](docs/examples.md) -- usage patterns and programmatic API
+- [Memory Management](docs/memory-management.md) -- compression, persistence, token tracking
+- [Extending](docs/extending.md) -- adding tools, agents, LLM providers
+- [Packaging](docs/packaging.md) -- building, publishing, Docker
+
+## License
+
+MIT License

aloop-0.1.1.dist-info/RECORD

@@ -0,0 +1,66 @@
+cli.py,sha256=j3B6la8ArJ5BAvR_vCw-_oDp8wyX9D25mKRJN96b8U8,338
+config.py,sha256=1D2VjNtZidj4NuA2AN013djKVFqxstc53zUd-Ppz2U4,4980
+interactive.py,sha256=TSoBsVuxsX_RxGFKRmqHEnQL7KOVL7s_GnCF7E3t6xc,34369
+main.py,sha256=P_96WocjwBkcBVj0zGy2r-S9FZbu8qpFXOdAvIaXkio,7710
+agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agent/agent.py,sha256=VfSQYKnLHiKU3mXJ9Ri8sHwYJpI7Ug14GgH3XqhoNO0,6597
+agent/base.py,sha256=WerzJeHo0zqw7Gllenf3cp3c2fqjzfu027p9js5jy1Q,15643
+agent/context.py,sha256=paxoP5KRqNMnEEREa9Mj8QVIdpgtpj9FafwtvuTe1I8,3793
+agent/todo.py,sha256=dM6DSCeV9QbatDVx1HEUK46b_XEdcPCf_1uYYZN4Fsg,5272
+agent/tool_executor.py,sha256=uvxwhiqQh4MkSZAhHbcUkFHRpuiM7XfMQOh_WCFMI_c,1951
+agent/verification.py,sha256=kFOLUJfd2iK5P_OIctacRNdGhwzNXTd_cdcXdv1xGqQ,4268
+agent/prompts/__init__.py,sha256=bnOLBsNS6jXAS6hQirULAoJ6gs1tC2suZ501i4KRRzA,36
+aloop-0.1.1.dist-info/licenses/LICENSE,sha256=QWrc--GLlkEskZCiT0qjbtLKXYA5It4gp345uIltMew,1066
+llm/__init__.py,sha256=GhTKAf36pjBV6fuijXTCBcLk4XqmUYeCbrZATvb_mW8,1149
+llm/base.py,sha256=mESX6l3dbZPfh9-l9txVvvVJWpgvNIchm3tD5MkAFn8,551
+llm/compat.py,sha256=tl5De-u86VuWLbeTmPrBVRosBtyPu3kM504fAwARFeI,6396
+llm/content_utils.py,sha256=tcwNRlMRpFEVeCsjyCcGrcy1WxtqLiK1kRXZw0_IL4U,8262
+llm/litellm_adapter.py,sha256=Zm4OSNC4oacLunf1Bkjkdnwwe4F9n0GNUeXbFcQeCFA,16934
+llm/message_types.py,sha256=sjcjsJGy1JtWMtjfqrrgpyVWntg6z47unxAHVID3QIQ,7117
+llm/model_manager.py,sha256=ms5MNAjlRWWV5RYbq60Qb0BbWrYfjpMkgphMu82RNJA,8704
+llm/retry.py,sha256=0ouN1yAD2mCNbtFbrTxAwWXiQAW7p1XIUei623WcUpw,2710
+memory/__init__.py,sha256=7iLqzMIysHkC_wqftqSPPFVF6peHlX_agtRTveWhHu4,578
+memory/compressor.py,sha256=edV7B61CipvgQq5LGGdOwOsoRiuHL2fz_sC-MnSyKSM,23238
+memory/manager.py,sha256=m0r3b47KXMj8ymAZeQwZ6pEFlRqHyqVdu4OlLQ-D4xc,19474
+memory/serialization.py,sha256=whX7E2n2UyamD1iOtQS2PkKhbb-ebwwnvfu-fh-Y2tE,2194
+memory/short_term.py,sha256=RHPvHxqAzSJq_FeepL5qk0v-zOYnTIKP6l_jtJ0jB7c,2519
+memory/token_tracker.py,sha256=xufZ-FWjcGkTdkK5jmns3CTIqklv6ctFCmKH5yl9uiY,6953
+memory/types.py,sha256=GLOLB0f0IN3cb7Bv-guVwtR17mJG7zlvJjRWtXlzyao,1744
+memory/store/__init__.py,sha256=23CgsW2M-exOH0pt3XEFvtNP1CQ15AgyMVo9rMHKGsc,205
+memory/store/memory_store.py,sha256=_R27AitWIP6GUIGN5x9QsjL6qKs2eWKfyVps8m3ekFw,2733
+memory/store/yaml_file_memory_store.py,sha256=5At2tba8Ccch97h58hiIH0L5yqhiqctuQD_OXxq8Z8U,14447
+tools/__init__.py,sha256=iAVcW_A4I2aVuiI3PoVMcCBe8cFGqe6TIBuaZ_cGD-Q,190
+tools/advanced_file_ops.py,sha256=dZlgOvAVOhVRIyOgwU6tlaSNituQoEivKxiHQo9DNME,19938
+tools/base.py,sha256=OtDzJg4c-CKtHTohPVaNDD_8x1xPKqCXE8SGJd8Xr_c,1397
+tools/calculator.py,sha256=Sl201BysnFa-7tduxKstnOT94syAHyle2rTgztXA6Ho,1500
+tools/code_navigator.py,sha256=Unj9mjbsTOJQNgVi980zrgeg1Msp3rHzqo-am8eqwEI,38336
+tools/explore.py,sha256=hR2_TMjVYCrqrj9JFSmTgIiXyvlE7_vFYtrlxLtVGG4,8171
+tools/file_ops.py,sha256=43qs42oIbCd9q7UD1scEKUAbKdRuzjukTjxw_ziJmuE,5082
+tools/git_tools.py,sha256=a0pLYnk4OjXB7ak3jmlQLIDet9Bf_rolNGsGHS7XgqA,23521
+tools/notify.py,sha256=gWlTx-9SSQ2bsITVkJPCUgX6Mm9ve2TtfgMHq4RksKM,2103
+tools/parallel_execute.py,sha256=AD_VwCchLOkHLYYliJn0dGupX4wB01X1RmV0Lz3DqXM,13197
+tools/session_manager.py,sha256=aXdRYWR9-NH5K-E1NfmjxG0txR5fvmhAX-mFjmq9N7c,6484
+tools/shell.py,sha256=Ozn4ldWA4DzIkNHt1HjXD_F0A300Zdnj7IYYlrGqIqo,5492
+tools/shell_background.py,sha256=aAduugXVEzs2IXFmXq62cHryZDKknKsmdxbI_0KgQK4,16070
+tools/smart_edit.py,sha256=GU3SYMnpr7DCXNVL8HqphwoajRERF1vQT_e1LXmcohw,17804
+tools/todo.py,sha256=nm3lKm-lE6ta0Q3g13XKLQ7L3JLATX4VuoZtUu9KvCU,4412
+tools/web_fetch.py,sha256=wW6zk0uA6nMuH5ecs2ExgdPJv9-tn3xP1H92-tc5ni4,24827
+tools/web_search.py,sha256=7D_86Jk8sQCOPCiMa_NtFXTpduZiXlwr7IRyREBRbIg,2025
+utils/__init__.py,sha256=WKSnJ2XGVq5199-gTkIO0Acd4RT9LZofDQeOkbzVq-c,424
+utils/logger.py,sha256=-8UiH5F5jm3IGbJvlcNhvkF_t8fUSKmuqnZPsLVSb8M,3072
+utils/model_pricing.py,sha256=r5LVdkQNqYMm8_W7Kb2iXu9oHHHz7zHjHYyEqOb3wRA,2311
+utils/runtime.py,sha256=tGl__Ss2SSEWsyMxEhklKPm2HrbbKRTzgtk7Tq5lCxU,1740
+utils/terminal_ui.py,sha256=kOfT9O2UdZCOcwfx0TZ6MziOgGEhC1C_eB6bjv0sH_0,12302
+utils/tui/__init__.py,sha256=bN2Iof8dzqp_zT7KRS9vFGWEb5pGsl36OQ9EtxmiOVw,915
+utils/tui/command_registry.py,sha256=EYsZssHLYDaoaVyc_t1MEWOiaD5RjyEGZS8jflEquIQ,1597
+utils/tui/components.py,sha256=m5FLAEfI-eO3773ug9qmTw5AXrjBtKIFyrCAb7Mibl4,9492
+utils/tui/input_handler.py,sha256=e2PtQRWG-VfRyq8VuhsaOFkE7dE0b8o3EUt5YPbsl-M,14022
+utils/tui/model_ui.py,sha256=Oqc-2NKGiyg-4fZNgnxO0drwrHVKrjK9EzTCwd4oXG4,6234
+utils/tui/progress.py,sha256=Yb0bn6XSBvluLSJqgkvHt_SMXDob5LwT-OwR1b7aMDE,8082
+utils/tui/status_bar.py,sha256=AG_zb9qGkkNGLMHdYgWBvnK8JVppmUVKjOmj-qCVLg4,5333
+utils/tui/theme.py,sha256=x0wnQw21Ufy1cm5DGMQroJ88J_rYBcezVHlwg4-mdwY,5606
+aloop-0.1.1.dist-info/METADATA,sha256=H3HAsDatOc5D7BiqSLTfWgBDZnHBtjvOLzTAfNGXHLQ,9232
+aloop-0.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+aloop-0.1.1.dist-info/entry_points.txt,sha256=fXfq7fpc79S3RQ7TzXSSyiA2L6yedfo-3o1PXEFXs0I,35
+aloop-0.1.1.dist-info/top_level.txt,sha256=RcMBYcKEUojok3GYEagBOce8M7DyEAelgCypkcTrSE0,57
+aloop-0.1.1.dist-info/RECORD,,

aloop-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

aloop-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+aloop = cli:main

aloop-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yixin Luo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+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.

aloop-0.1.1.dist-info/top_level.txt

@@ -0,0 +1,9 @@
+agent
+cli
+config
+interactive
+llm
+main
+memory
+tools
+utils

cli.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python3
+"""Command-line interface for aloop."""
+
+import os
+import sys
+
+# Add current directory to path to allow imports
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+
+def main():
+    """Main CLI entry point."""
+    from main import main as run_main
+
+    run_main()
+
+
+if __name__ == "__main__":
+    main()

config.py

@@ -0,0 +1,146 @@
+"""Configuration management for the agentic system."""
+
+import os
+import random
+
+# Define path constants directly to avoid circular imports with utils
+# (utils.terminal_ui imports Config, and utils.runtime is in the utils package)
+_RUNTIME_DIR = os.path.join(os.path.expanduser("~"), ".aloop")
+_CONFIG_FILE = os.path.join(_RUNTIME_DIR, "config")
+
+# Default configuration template
+_DEFAULT_CONFIG = """\
+# aloop Configuration
+#
+# NOTE: Model configuration lives in `~/.aloop/models.yaml`.
+# This file controls non-model runtime settings only.
+
+TOOL_TIMEOUT=600
+MAX_ITERATIONS=1000
+
+# Ralph Loop (outer verification loop — re-checks task completion)
+# RALPH_LOOP_MAX_ITERATIONS=3
+"""
+
+
+def _load_config(path: str) -> dict[str, str]:
+    """Parse a KEY=VALUE config file, skipping comments and blank lines."""
+    cfg: dict[str, str] = {}
+    if not os.path.isfile(path):
+        return cfg
+    with open(path, encoding="utf-8") as f:
+        for line in f:
+            line = line.strip()
+            if not line or line.startswith("#"):
+                continue
+            if "=" not in line:
+                continue
+            key, _, value = line.partition("=")
+            # Strip inline comments (# ...) from the value
+            if "#" in value:
+                value = value[: value.index("#")]
+            cfg[key.strip()] = value.strip()
+    return cfg
+
+
+def _ensure_config():
+    """Ensure ~/.aloop/config exists, create with defaults if not."""
+    if not os.path.exists(_CONFIG_FILE):
+        os.makedirs(_RUNTIME_DIR, exist_ok=True)
+        with open(_CONFIG_FILE, "w", encoding="utf-8") as f:
+            f.write(_DEFAULT_CONFIG)
+
+
+# Ensure config exists and load it
+_ensure_config()
+_cfg = _load_config(_CONFIG_FILE)
+
+
+def get_raw_config() -> dict[str, str]:
+    """Get the raw config dictionary.
+
+    Returns:
+        Dictionary of config key-value pairs
+    """
+    return _cfg.copy()
+
+
+class Config:
+    """Configuration for the agentic system.
+
+    All configuration is centralized here. Access config values directly via Config.XXX.
+    """
+
+    # Model configuration is handled by `~/.aloop/models.yaml` via ModelManager.
+    # `~/.aloop/config` controls non-model runtime settings only.
+    TOOL_TIMEOUT = float(_cfg.get("TOOL_TIMEOUT", "600"))
+
+    # Agent Configuration
+    MAX_ITERATIONS = int(_cfg.get("MAX_ITERATIONS", "1000"))
+
+    # Ralph Loop (outer verification loop)
+    RALPH_LOOP_MAX_ITERATIONS = int(_cfg.get("RALPH_LOOP_MAX_ITERATIONS", "3"))
+
+    # Retry Configuration
+    RETRY_MAX_ATTEMPTS = int(_cfg.get("RETRY_MAX_ATTEMPTS", "3"))
+    RETRY_INITIAL_DELAY = float(_cfg.get("RETRY_INITIAL_DELAY", "1.0"))
+    RETRY_MAX_DELAY = float(_cfg.get("RETRY_MAX_DELAY", "60.0"))
+    RETRY_EXPONENTIAL_BASE = 2.0
+    RETRY_JITTER = True
+
+    # Memory Management Configuration
+    MEMORY_ENABLED = _cfg.get("MEMORY_ENABLED", "true").lower() == "true"
+    MEMORY_COMPRESSION_THRESHOLD = int(_cfg.get("MEMORY_COMPRESSION_THRESHOLD", "60000"))
+    MEMORY_SHORT_TERM_SIZE = int(_cfg.get("MEMORY_SHORT_TERM_SIZE", "100"))
+    MEMORY_SHORT_TERM_MIN_SIZE = int(_cfg.get("MEMORY_SHORT_TERM_MIN_SIZE", "6"))
+    MEMORY_COMPRESSION_RATIO = float(_cfg.get("MEMORY_COMPRESSION_RATIO", "0.3"))
+    MEMORY_PRESERVE_SYSTEM_PROMPTS = True
+
+    # Logging Configuration
+    # Note: Logging is now controlled via --verbose flag
+    # LOG_DIR is now ~/.aloop/logs/ (see utils.runtime)
+    LOG_LEVEL = _cfg.get("LOG_LEVEL", "DEBUG").upper()
+
+    # TUI Configuration
+    TUI_THEME = _cfg.get("TUI_THEME", "dark")  # "dark" or "light"
+    TUI_SHOW_THINKING = _cfg.get("TUI_SHOW_THINKING", "true").lower() == "true"
+    TUI_THINKING_MAX_PREVIEW = int(_cfg.get("TUI_THINKING_MAX_PREVIEW", "300"))
+    TUI_STATUS_BAR = _cfg.get("TUI_STATUS_BAR", "true").lower() == "true"
+    TUI_COMPACT_MODE = _cfg.get("TUI_COMPACT_MODE", "false").lower() == "true"
+
+    # Email Notification Configuration (Resend)
+    RESEND_API_KEY = _cfg.get("RESEND_API_KEY") or ""
+    NOTIFY_EMAIL_FROM = _cfg.get("NOTIFY_EMAIL_FROM") or ""
+
+    @classmethod
+    def get_retry_delay(cls, attempt: int) -> float:
+        """Calculate delay for a given retry attempt using exponential backoff.
+
+        Args:
+            attempt: Current attempt number (0-indexed)
+
+        Returns:
+            Delay in seconds
+        """
+        # Calculate exponential backoff
+        delay = min(
+            cls.RETRY_INITIAL_DELAY * (cls.RETRY_EXPONENTIAL_BASE**attempt),
+            cls.RETRY_MAX_DELAY,
+        )
+
+        # Add jitter to avoid thundering herd
+        if cls.RETRY_JITTER:
+            delay = delay * (0.5 + random.random())
+
+        return delay
+
+    @classmethod
+    def validate(cls):
+        """Validate required configuration.
+
+        Raises:
+            ValueError: If required configuration is missing
+        """
+        # Model configuration is handled by `~/.aloop/models.yaml` via ModelManager.
+        # `~/.aloop/config` is used for non-model runtime settings only.
+        return