ToolLane (Python)

Part of LoopEngine — a runtime for defining and running AI agents through a transparent ReAct loop — scheduling approved tool calls into parallel/solo execution lanes. Works standalone too, no dependency on LoopEngine itself.

Ported line-for-line from the TypeScript implementation. See the root README for the pitch, the prior-art table, and the scope decisions — this file only covers what's specific to running the Python code.

Install

pip install -e ".[dev]"

Quickstart

PYTHONPATH=src python3 examples/quickstart.py

from toollane import ToolLane

tool_lane = ToolLane(is_safe=lambda call: call.name in {"read_file", "list_dir", "grep"})

for lane in tool_lane.plan(calls):
    print(lane.mode, [c.name for c in lane.calls])

async for result in tool_lane.run(calls):
    # result.status is "fulfilled" or "rejected" — one failure never
    # stops the rest of the batch.
    ...

Test

pytest

Status

Lane scheduling, streamed execution via an async generator, and isolated failure handling are real and tested. Published as toollane on PyPI.