recursive-agent 0.8.2

A Rust coding-agent platform: kernel, tools, multi-agent orchestration, HTTP API, MCP, and TUI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

name: "Session JSONL Persistence"
description: "Verify session produces valid .meta.json + transcript.jsonl."
sequential: true

setup:
  - name: "Prepare workspace + RECURSIVE_HOME"
    exec:
      container: recursive-e2e
      command: |
        rm -rf /workspace/test-02
        rm -rf /tmp/recursive-home-02
        rm -rf /tmp/sessions-02
        mkdir -p /workspace/test-02
        mkdir -p /tmp/recursive-home-02
        echo prepared

  - name: "Run agent (act): list_dir on workspace root"
    exec:
      container: recursive-e2e
      command: |
        unset RECURSIVE_SESSIONS_DIR  # container-wide override would write the session outside RECURSIVE_HOME
        RECURSIVE_HOME=/tmp/recursive-home-02 \
        recursive --workspace /workspace/test-02 \
          --api-base http://aimock:4010/v1 --api-key mock-key -m mock-chat \
          --max-steps 10 \
          run "List the files in the workspace root using list_dir tool."
        SESSION_DIR=$(find /tmp/recursive-home-02 -name '.meta.json' -exec dirname {} \; 2>/dev/null | head -1)
        if [ -n "$SESSION_DIR" ]; then
          mkdir -p /tmp/sessions-02
          cp -r "$SESSION_DIR/." /tmp/sessions-02/
        fi

cases:
  - name: "Session structure is valid"
    recursive-session:
      container: recursive-e2e
      input: /tmp/sessions-02
      status: ["completed", "success"]
      hasRoles: ["user", "assistant"]
      hasToolCalls: ["list_dir"]
      minMessages: 3
      finalized: true

teardown:
  - name: "Clean workspace + RECURSIVE_HOME + session copy"
    ignoreError: true
    exec:
      container: recursive-e2e
      command: |
        rm -rf /workspace/test-02
        rm -rf /tmp/recursive-home-02
        rm -rf /tmp/sessions-02