Skip to main content

Recursive context-aware reasoning & planning for LLM agents — the ReCAP loop (arXiv:2510.23822) as a thin, provider-agnostic library.

Project description

recurve

Recursive context-aware reasoning & planning for LLM agents.

recurve is a thin, async-first, provider-agnostic Python library implementing the ReCAP loop — Recursive Context-Aware Reasoning and Planning (arXiv:2510.23822, NeurIPS 2025).

Its one defensible novelty, packaged nowhere else: ReCAP's single shared sliding-window context with structured re-injection of the parent's remaining plan on return — not isolated sub-agent contexts, not a graph engine. The loop:

  1. plan-ahead — emit the whole ordered subtask list, but execute only the first item;
  2. recurse on composite subtasks within the same shared context;
  3. re-inject the parent's remaining plan when a subtask returns;
  4. refine the remaining plan after each step.

Provider plumbing, typed structured outputs, retries, and tracing are reused (Pydantic AI / LiteLLM behind a tiny 2-method Model protocol), never reinvented.

Part of the AETHEL project. MIT licensed. Status: alpha (Phase 1).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

recurve-0.1.0.tar.gz (14.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

recurve-0.1.0-py3-none-any.whl (20.5 kB view details)

Uploaded Python 3

File details

Details for the file recurve-0.1.0.tar.gz.

File metadata

  • Download URL: recurve-0.1.0.tar.gz
  • Upload date:
  • Size: 14.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.24 {"installer":{"name":"uv","version":"0.11.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for recurve-0.1.0.tar.gz
Algorithm Hash digest
SHA256 73ce51629a1eea4ad34111f4653a0d4fbbfad4c91cdd828c8cbd954e09d5cfff
MD5 8b69f44d79481ab540b85cb229548899
BLAKE2b-256 b09a032e127708b74b3e0b9549d7aa8dd54dc6fc131eca68f125cb23edc9f6ce

See more details on using hashes here.

File details

Details for the file recurve-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: recurve-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 20.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.24 {"installer":{"name":"uv","version":"0.11.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for recurve-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 227ef99cceddde2299d684184bbd5ecc9123ec445cf86debb7b597ea1cd80e3c
MD5 2d35c36c87a9c42bab58265bee7692d7
BLAKE2b-256 fc49f238fdcedbef42c8c18d91e5e0face8a6098a42d09a7380181ba58efe364

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page