async-repl-protocol

Agentica 异步 REPL 协议规范与使用规则，约束响应与 await 行为。

这是 Agentica 的异步 REPL 使用规范，告诉你在 REPL 环境里什么时候必须用 await 去等待会返回 Future 的工具，以及如何组织代码块以确保被正确执行。用在写测试或通过 REPL 调用异步工具时，能避免调用不生效或结果丢失的问题。需要注意一次响应里只放一个可执行的代码块，并且所有异步调用都要正确 await。

# Async REPL Protocol

When working with Agentica's async REPL harness for testing.

## Rules

### 1. Use `await` for Future-returning tools

```python
content = await view_file(path)  # NOT view_file(path)
answer = await ask_memory("...")
```

### 2. Single code block per response

Compute AND return in ONE block. Multiple blocks means only first executes.

```python
# GOOD: Single block
content = await view_file(path)
return any(c.isdigit() for c in content)

# BAD: Split blocks (second block never runs)
content = await view_file(path)