agent-control-plane 0.1.0

package/tools/tests/test-agent-project-openclaw-session-wrapper-recovers-version-mismatch.sh

@@ -0,0 +1,135 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SESSION_SRC="${FLOW_ROOT}/tools/bin/agent-project-run-openclaw-session"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+tools_dir="$tmpdir/tools"
+bin_dir="$tmpdir/bin"
+worktree="$tmpdir/worktree"
+runs_root="$tmpdir/runs"
+prompt_file="$tmpdir/prompt.md"
+session="resident-version-reset"
+run_dir="$runs_root/$session"
+operation_log="$tmpdir/openclaw.log"
+attempt_file="$tmpdir/attempts"
+resident_agent_dir="$tmpdir/resident/openclaw-agent"
+
+mkdir -p "$tools_dir" "$bin_dir" "$worktree" "$runs_root"
+cp "$SESSION_SRC" "$tools_dir/agent-project-run-openclaw-session"
+
+cat >"$bin_dir/openclaw" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+op_log="${ACP_TEST_OP_LOG:?}"
+attempt_file="${ACP_TEST_ATTEMPT_FILE:?}"
+cmd="${1:-}"
+sub="${2:-}"
+
+case "$cmd:$sub" in
+  agents:list)
+    shift 2 || true
+    printf 'agents:list\n' >>"$op_log"
+    if [[ -f "${ACP_RESIDENT_OPENCLAW_AGENT_DIR}/created" ]]; then
+      printf '{"agents":[{"id":"resident-agent"}]}\n'
+    else
+      printf '{"agents":[]}\n'
+    fi
+    ;;
+  agents:add)
+    shift 2 || true
+    agent_id="${1:-}"
+    printf 'agents:add:%s\n' "$agent_id" >>"$op_log"
+    mkdir -p "${ACP_RESIDENT_OPENCLAW_AGENT_DIR}"
+    : >"${ACP_RESIDENT_OPENCLAW_AGENT_DIR}/created"
+    printf '{"agentId":"%s"}\n' "$agent_id"
+    ;;
+  agents:delete)
+    shift 2 || true
+    printf 'agents:delete\n' >>"$op_log"
+    rm -f "${ACP_RESIDENT_OPENCLAW_AGENT_DIR}/created"
+    printf '{"deleted":true}\n'
+    ;;
+  agent:*)
+    current_attempt=0
+    if [[ -f "$attempt_file" ]]; then
+      current_attempt="$(cat "$attempt_file")"
+    fi
+    current_attempt=$((current_attempt + 1))
+    printf '%s\n' "$current_attempt" >"$attempt_file"
+    printf 'agent:run:%s\n' "$current_attempt" >>"$op_log"
+    if [[ "$current_attempt" == "1" ]]; then
+      printf 'Config was last written by a newer OpenClaw (2026.3.23-2); current version is 2026.3.12.\n' >&2
+      exit 1
+    fi
+    mkdir -p "${ACP_RUN_DIR:?}"
+    cat >"${ACP_RESULT_FILE:?}" <<'RESULT'
+OUTCOME=implemented
+ACTION=host-publish-issue-pr
+RESULT
+    printf '{"status":"pass","command":"mock verification"}\n' >"${ACP_RUN_DIR}/verification.jsonl"
+    printf '{"payloads":[{"text":"DONE"}]}\n'
+    ;;
+  *)
+    echo "unexpected openclaw args: $cmd $sub $*" >&2
+    exit 64
+    ;;
+esac
+EOF
+
+chmod +x "$tools_dir/agent-project-run-openclaw-session" "$bin_dir/openclaw"
+
+git -C "$worktree" init -b test >/dev/null 2>&1
+git -C "$worktree" config user.name "OpenClaw"
+git -C "$worktree" config user.email "openclaw@example.com"
+printf 'seed\n' >"$worktree/README.md"
+git -C "$worktree" add README.md
+git -C "$worktree" commit -m "init" >/dev/null 2>&1
+printf 'Prompt body\n' >"$prompt_file"
+
+PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+bash "$tools_dir/agent-project-run-openclaw-session" \
+  --mode safe \
+  --session "$session" \
+  --worktree "$worktree" \
+  --prompt-file "$prompt_file" \
+  --runs-root "$runs_root" \
+  --adapter-id alpha \
+  --task-kind issue \
+  --task-id 123 \
+  --keep-agent \
+  --openclaw-agent-id resident-agent \
+  --openclaw-session-id resident-session \
+  --openclaw-agent-dir "$resident_agent_dir" \
+  --openclaw-state-dir "$tmpdir/resident/openclaw-state" \
+  --openclaw-config-path "$tmpdir/resident/openclaw-config/openclaw.json" \
+  --openclaw-model mock/model \
+  --context "TEST_OP_LOG=$operation_log" \
+  --context "TEST_ATTEMPT_FILE=$attempt_file" \
+  --context "RESIDENT_OPENCLAW_AGENT_DIR=$resident_agent_dir" \
+  >/dev/null
+
+for _ in $(seq 1 50); do
+  if ! tmux has-session -t "$session" 2>/dev/null; then
+    break
+  fi
+  sleep 0.2
+done
+
+if tmux has-session -t "$session" 2>/dev/null; then
+  echo "tmux session did not exit" >&2
+  exit 1
+fi
+
+test -f "$run_dir/result.env"
+grep -q '^OUTCOME=implemented$' "$run_dir/result.env"
+grep -q '^ACTION=host-publish-issue-pr$' "$run_dir/result.env"
+grep -q '^agents:add:resident-agent$' "$operation_log"
+[[ "$(grep -c '^agents:add:resident-agent$' "$operation_log" || true)" == "2" ]]
+[[ "$(grep -c '^agent:run:' "$operation_log" || true)" == "2" ]]
+
+echo "agent-project openclaw session wrapper recovers version mismatch test passed"

package/tools/tests/test-agent-project-openclaw-session-wrapper-resident.sh

@@ -0,0 +1,179 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SESSION_SRC="${FLOW_ROOT}/tools/bin/agent-project-run-openclaw-session"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+tools_dir="$tmpdir/tools"
+bin_dir="$tmpdir/bin"
+worktree_one="$tmpdir/worktree-one"
+worktree_two="$tmpdir/worktree-two"
+runs_root="$tmpdir/runs"
+prompt_file="$tmpdir/prompt.md"
+session="resident-issue-openclaw"
+run_dir="$runs_root/$session"
+operation_log="$tmpdir/openclaw.log"
+state_file="$tmpdir/agent-present"
+config_path="$tmpdir/resident/openclaw-config/openclaw.json"
+
+mkdir -p "$tools_dir" "$bin_dir" "$worktree_one" "$worktree_two" "$runs_root"
+cp "$SESSION_SRC" "$tools_dir/agent-project-run-openclaw-session"
+
+cat >"$bin_dir/openclaw" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+op_log="${ACP_TEST_OP_LOG:?}"
+state_file="${ACP_TEST_STATE_FILE:?}"
+cmd="${1:-}"
+sub="${2:-}"
+
+case "$cmd:$sub" in
+  agents:list)
+    shift 2 || true
+    printf 'agents:list\n' >>"$op_log"
+    if [[ -f "$state_file" ]]; then
+      printf '{"agents":[{"id":"resident-agent"}]}\n'
+    else
+      printf '{"agents":[]}\n'
+    fi
+    ;;
+  agents:add)
+    shift 2 || true
+    agent_id="${1:-}"
+    printf 'agents:add:%s\n' "$agent_id" >>"$op_log"
+    : >"$state_file"
+    mkdir -p .openclaw
+    printf 'state\n' >.openclaw/workspace-state.json
+    : >SOUL.md
+    : >TOOLS.md
+    : >IDENTITY.md
+    : >USER.md
+    : >HEARTBEAT.md
+    : >BOOTSTRAP.md
+    printf '{"agentId":"%s"}\n' "$agent_id"
+    ;;
+  agents:delete)
+    shift 2 || true
+    agent_id="${1:-}"
+    printf 'agents:delete:%s\n' "$agent_id" >>"$op_log"
+    rm -f "$state_file"
+    printf '{"deleted":true}\n'
+    ;;
+  agent:*)
+    shift 1 || true
+    agent_id=""
+    session_id=""
+    while [[ $# -gt 0 ]]; do
+      case "$1" in
+        --agent) agent_id="${2:-}"; shift 2 ;;
+        --session-id) session_id="${2:-}"; shift 2 ;;
+        *) shift ;;
+      esac
+    done
+    printf 'agent:run:%s:%s\n' "$agent_id" "$session_id" >>"$op_log"
+    mkdir -p "${ACP_RUN_DIR:?}"
+    cat >"${ACP_RESULT_FILE:?}" <<'RESULT'
+OUTCOME=implemented
+ACTION=host-publish-issue-pr
+RESULT
+    printf 'artifact-from-openclaw\n' >"${ACP_RUN_DIR}/mock.txt"
+    printf '{"status":"pass","command":"mock verification"}\n' >"${ACP_RUN_DIR}/verification.jsonl"
+    printf '{"payloads":[{"text":"DONE"}]}\n'
+    ;;
+  *)
+    echo "unexpected openclaw args: $cmd $sub $*" >&2
+    exit 64
+    ;;
+esac
+EOF
+
+chmod +x "$tools_dir/agent-project-run-openclaw-session" "$bin_dir/openclaw"
+
+for worktree in "$worktree_one" "$worktree_two"; do
+  git -C "$worktree" init -b test >/dev/null 2>&1
+  git -C "$worktree" config user.name "OpenClaw"
+  git -C "$worktree" config user.email "openclaw@example.com"
+  printf 'seed\n' >"$worktree/README.md"
+  git -C "$worktree" add README.md
+  git -C "$worktree" commit -m "init" >/dev/null 2>&1
+done
+printf 'Prompt body\n' >"$prompt_file"
+
+run_wrapper() {
+  local worktree="${1:?worktree required}"
+  PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+  bash "$tools_dir/agent-project-run-openclaw-session" \
+    --mode safe \
+    --session "$session" \
+    --worktree "$worktree" \
+    --prompt-file "$prompt_file" \
+    --runs-root "$runs_root" \
+    --adapter-id alpha \
+    --task-kind issue \
+    --task-id 123 \
+    --keep-agent \
+    --openclaw-agent-id resident-agent \
+    --openclaw-session-id resident-session \
+    --openclaw-agent-dir "$tmpdir/resident/openclaw-agent" \
+    --openclaw-state-dir "$tmpdir/resident/openclaw-state" \
+    --openclaw-config-path "$config_path" \
+    --openclaw-model mock/model \
+    --context "TEST_OP_LOG=$operation_log" \
+    --context "TEST_STATE_FILE=$state_file" \
+    --collect-file mock.txt \
+    >/dev/null
+
+  for _ in $(seq 1 50); do
+    if ! tmux has-session -t "$session" 2>/dev/null; then
+      break
+    fi
+    sleep 0.2
+  done
+
+  if tmux has-session -t "$session" 2>/dev/null; then
+    echo "tmux session did not exit" >&2
+    exit 1
+  fi
+}
+
+run_wrapper "$worktree_one"
+run_wrapper "$worktree_two"
+
+test -f "$run_dir/result.env"
+test -f "$run_dir/mock.txt"
+grep -q '^OUTCOME=implemented$' "$run_dir/result.env"
+grep -q '^ACTION=host-publish-issue-pr$' "$run_dir/result.env"
+grep -q '^OPENCLAW_KEEP_AGENT=true$' "$run_dir/run.env"
+test -f "$config_path"
+python3 - "$config_path" "$worktree_two" "$tmpdir/resident/openclaw-agent" <<'PY'
+import json
+import sys
+
+config_path, expected_workspace, expected_agent_dir = sys.argv[1:4]
+with open(config_path, "r", encoding="utf-8") as handle:
+    payload = json.load(handle)
+agents = payload.get("agents", {}).get("list", [])
+resident = next((agent for agent in agents if agent.get("id") == "resident-agent"), None)
+if resident is None:
+    raise SystemExit(1)
+if resident.get("workspace") != expected_workspace:
+    raise SystemExit(1)
+if resident.get("agentDir") != expected_agent_dir:
+    raise SystemExit(1)
+if resident.get("model") != "mock/model":
+    raise SystemExit(1)
+PY
+
+add_count="$(grep -c '^agents:add:resident-agent$' "$operation_log" || true)"
+run_count="$(grep -c '^agent:run:resident-agent:resident-session$' "$operation_log" || true)"
+delete_count="$(grep -c '^agents:delete:resident-agent$' "$operation_log" || true)"
+
+[[ "$add_count" == "1" ]]
+[[ "$run_count" == "2" ]]
+[[ "$delete_count" == "0" ]]
+
+echo "agent-project openclaw resident session wrapper test passed"

package/tools/tests/test-agent-project-openclaw-session-wrapper-reuses-existing-agent-after-add-race.sh

@@ -0,0 +1,119 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SESSION_SRC="${FLOW_ROOT}/tools/bin/agent-project-run-openclaw-session"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+tools_dir="$tmpdir/tools"
+bin_dir="$tmpdir/bin"
+worktree="$tmpdir/worktree"
+runs_root="$tmpdir/runs"
+prompt_file="$tmpdir/prompt.md"
+session="resident-add-race"
+run_dir="$runs_root/$session"
+operation_log="$tmpdir/openclaw.log"
+
+mkdir -p "$tools_dir" "$bin_dir" "$worktree" "$runs_root"
+cp "$SESSION_SRC" "$tools_dir/agent-project-run-openclaw-session"
+
+cat >"$bin_dir/openclaw" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+op_log="${ACP_TEST_OP_LOG:?}"
+cmd="${1:-}"
+sub="${2:-}"
+
+case "$cmd:$sub" in
+  agents:list)
+    shift 2 || true
+    printf 'agents:list\n' >>"$op_log"
+    printf '{"agents":[]}\n'
+    ;;
+  agents:add)
+    shift 2 || true
+    agent_id="${1:-}"
+    printf 'agents:add:%s\n' "$agent_id" >>"$op_log"
+    printf 'Agent "%s" already exists.\n' "$agent_id" >&2
+    exit 1
+    ;;
+  agent:*)
+    shift 1 || true
+    agent_id=""
+    session_id=""
+    while [[ $# -gt 0 ]]; do
+      case "$1" in
+        --agent) agent_id="${2:-}"; shift 2 ;;
+        --session-id) session_id="${2:-}"; shift 2 ;;
+        *) shift ;;
+      esac
+    done
+    printf 'agent:run:%s:%s\n' "$agent_id" "$session_id" >>"$op_log"
+    mkdir -p "${ACP_RUN_DIR:?}"
+    cat >"${ACP_RESULT_FILE:?}" <<'RESULT'
+OUTCOME=implemented
+ACTION=host-publish-issue-pr
+RESULT
+    printf '{"status":"pass","command":"mock verification"}\n' >"${ACP_RUN_DIR}/verification.jsonl"
+    printf '{"payloads":[{"text":"DONE"}]}\n'
+    ;;
+  *)
+    echo "unexpected openclaw args: $cmd $sub $*" >&2
+    exit 64
+    ;;
+esac
+EOF
+
+chmod +x "$tools_dir/agent-project-run-openclaw-session" "$bin_dir/openclaw"
+
+git -C "$worktree" init -b test >/dev/null 2>&1
+git -C "$worktree" config user.name "OpenClaw"
+git -C "$worktree" config user.email "openclaw@example.com"
+printf 'seed\n' >"$worktree/README.md"
+git -C "$worktree" add README.md
+git -C "$worktree" commit -m "init" >/dev/null 2>&1
+printf 'Prompt body\n' >"$prompt_file"
+
+PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+bash "$tools_dir/agent-project-run-openclaw-session" \
+  --mode safe \
+  --session "$session" \
+  --worktree "$worktree" \
+  --prompt-file "$prompt_file" \
+  --runs-root "$runs_root" \
+  --adapter-id alpha \
+  --task-kind issue \
+  --task-id 123 \
+  --keep-agent \
+  --openclaw-agent-id resident-agent \
+  --openclaw-session-id resident-session \
+  --openclaw-agent-dir "$tmpdir/resident/openclaw-agent" \
+  --openclaw-state-dir "$tmpdir/resident/openclaw-state" \
+  --openclaw-config-path "$tmpdir/resident/openclaw-config/openclaw.json" \
+  --openclaw-model mock/model \
+  --context "TEST_OP_LOG=$operation_log" \
+  >/dev/null
+
+for _ in $(seq 1 50); do
+  if ! tmux has-session -t "$session" 2>/dev/null; then
+    break
+  fi
+  sleep 0.2
+done
+
+if tmux has-session -t "$session" 2>/dev/null; then
+  echo "tmux session did not exit" >&2
+  exit 1
+fi
+
+test -f "$run_dir/result.env"
+grep -q '^OUTCOME=implemented$' "$run_dir/result.env"
+grep -q '^ACTION=host-publish-issue-pr$' "$run_dir/result.env"
+grep -q 'reusing existing agent after add race' "$run_dir/$session.log"
+[[ "$(grep -c '^agents:add:resident-agent$' "$operation_log" || true)" == "1" ]]
+[[ "$(grep -c '^agent:run:resident-agent:resident-session$' "$operation_log" || true)" == "1" ]]
+
+echo "agent-project openclaw session wrapper reuses existing agent after add race test passed"

package/tools/tests/test-agent-project-openclaw-session-wrapper-terminates-rate-limit-hang.sh

@@ -0,0 +1,91 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SESSION_SRC="${FLOW_ROOT}/tools/bin/agent-project-run-openclaw-session"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+tools_dir="$tmpdir/tools"
+bin_dir="$tmpdir/bin"
+worktree="$tmpdir/worktree"
+runs_root="$tmpdir/runs"
+prompt_file="$tmpdir/prompt.md"
+session="openclaw-rate-limit-hang"
+run_dir="$runs_root/$session"
+
+mkdir -p "$tools_dir" "$bin_dir" "$worktree" "$runs_root"
+cp "$SESSION_SRC" "$tools_dir/agent-project-run-openclaw-session"
+
+cat >"$bin_dir/openclaw" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+cmd="${1:-}"
+sub="${2:-}"
+
+case "$cmd:$sub" in
+  agents:list)
+    printf '{"agents":[]}\n'
+    ;;
+  agents:add)
+    shift 2 || true
+    printf '{"agentId":"%s"}\n' "${1:-agent}"
+    ;;
+  agent:*)
+    printf '429 Provider returned error stepfun/step-3.5-flash:free is temporarily rate-limited upstream.\n' >&2
+    trap 'exit 1' TERM INT
+    while true; do
+      sleep 1
+    done
+    ;;
+  *)
+    echo "unexpected openclaw args: $cmd $sub $*" >&2
+    exit 64
+    ;;
+esac
+EOF
+
+chmod +x "$tools_dir/agent-project-run-openclaw-session" "$bin_dir/openclaw"
+
+git -C "$worktree" init -b test >/dev/null 2>&1
+git -C "$worktree" config user.name "OpenClaw"
+git -C "$worktree" config user.email "openclaw@example.com"
+printf 'seed\n' >"$worktree/README.md"
+git -C "$worktree" add README.md
+git -C "$worktree" commit -m "init" >/dev/null 2>&1
+printf 'Prompt body\n' >"$prompt_file"
+
+PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+bash "$tools_dir/agent-project-run-openclaw-session" \
+  --mode safe \
+  --session "$session" \
+  --worktree "$worktree" \
+  --prompt-file "$prompt_file" \
+  --runs-root "$runs_root" \
+  --adapter-id alpha \
+  --task-kind issue \
+  --task-id 123 \
+  --openclaw-model mock/model \
+  --openclaw-timeout-seconds 30 \
+  >/dev/null
+
+for _ in $(seq 1 50); do
+  if ! tmux has-session -t "$session" 2>/dev/null; then
+    break
+  fi
+  sleep 0.2
+done
+
+if tmux has-session -t "$session" 2>/dev/null; then
+  echo "tmux session did not exit after rate limit hang" >&2
+  exit 1
+fi
+
+test -f "$run_dir/runner.env"
+grep -q '^RUNNER_STATE=failed$' "$run_dir/runner.env"
+grep -q '^LAST_FAILURE_REASON=provider-quota-limit$' "$run_dir/runner.env"
+grep -q 'rate-limited upstream' "$run_dir/$session.log"
+
+echo "agent-project openclaw session wrapper terminates rate limit hang test passed"

package/tools/tests/test-agent-project-openclaw-session-wrapper.sh

@@ -0,0 +1,117 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+FLOW_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+SESSION_SRC="${FLOW_ROOT}/tools/bin/agent-project-run-openclaw-session"
+
+tmpdir="$(mktemp -d)"
+trap 'rm -rf "$tmpdir"' EXIT
+
+tools_dir="$tmpdir/tools"
+bin_dir="$tmpdir/bin"
+worktree="$tmpdir/worktree"
+runs_root="$tmpdir/runs"
+prompt_file="$tmpdir/prompt.md"
+session="fl-issue-openclaw-wrapper"
+run_dir="$runs_root/$session"
+reconcile_log="$tmpdir/reconcile.log"
+
+mkdir -p "$tools_dir" "$bin_dir" "$worktree" "$runs_root"
+cp "$SESSION_SRC" "$tools_dir/agent-project-run-openclaw-session"
+
+cat >"$bin_dir/openclaw" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+cmd="${1:-}"
+sub="${2:-}"
+case "$cmd:$sub" in
+  agents:add)
+    mkdir -p .openclaw
+    printf 'state\n' >.openclaw/workspace-state.json
+    : >SOUL.md
+    : >TOOLS.md
+    : >IDENTITY.md
+    : >USER.md
+    : >HEARTBEAT.md
+    : >BOOTSTRAP.md
+    printf '{"agentId":"stub"}\n'
+    ;;
+  agent:*)
+    mkdir -p "${ACP_RUN_DIR:?}"
+    cat >"${ACP_RESULT_FILE:?}" <<'RESULT'
+OUTCOME=implemented
+ACTION=host-publish-issue-pr
+RESULT
+    printf 'artifact-from-openclaw\n' >"${ACP_RUN_DIR}/mock.txt"
+    printf '{"status":"pass","command":"mock verification"}\n' >"${ACP_RUN_DIR}/verification.jsonl"
+    printf '{"payloads":[{"text":"DONE"}]}\n'
+    ;;
+  *)
+    echo "unexpected openclaw args: $*" >&2
+    exit 64
+    ;;
+esac
+EOF
+
+chmod +x "$tools_dir/agent-project-run-openclaw-session" "$bin_dir/openclaw"
+
+git -C "$worktree" init -b test >/dev/null 2>&1
+git -C "$worktree" config user.name "OpenClaw"
+git -C "$worktree" config user.email "openclaw@example.com"
+printf 'seed\n' >"$worktree/README.md"
+git -C "$worktree" add README.md
+git -C "$worktree" commit -m "init" >/dev/null 2>&1
+printf 'Prompt body\n' >"$prompt_file"
+
+PATH="$bin_dir:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin" \
+bash "$tools_dir/agent-project-run-openclaw-session" \
+  --mode safe \
+  --session "$session" \
+  --worktree "$worktree" \
+  --prompt-file "$prompt_file" \
+  --runs-root "$runs_root" \
+  --adapter-id alpha \
+  --task-kind issue \
+  --task-id 123 \
+  --openclaw-model mock/model \
+  --collect-file mock.txt \
+  --reconcile-command "printf 'reconciled\n' >> '$reconcile_log'" \
+  >/dev/null
+
+for _ in $(seq 1 50); do
+  if ! tmux has-session -t "$session" 2>/dev/null; then
+    break
+  fi
+  sleep 0.2
+done
+
+if tmux has-session -t "$session" 2>/dev/null; then
+  echo "tmux session did not exit" >&2
+  exit 1
+fi
+
+for _ in $(seq 1 25); do
+  [[ -f "$reconcile_log" ]] && break
+  sleep 0.2
+done
+
+test -f "$run_dir/result.env"
+test -f "$run_dir/mock.txt"
+grep -q '^OUTCOME=implemented$' "$run_dir/result.env"
+grep -q '^ACTION=host-publish-issue-pr$' "$run_dir/result.env"
+grep -q 'artifact-from-openclaw' "$run_dir/mock.txt"
+grep -q '__CODEX_EXIT__:0' "$run_dir/$session.log"
+grep -q '^reconciled$' "$reconcile_log"
+grep -q '^FINAL_HEAD=' "$run_dir/run.env"
+grep -q '^FINAL_BRANCH=test$' "$run_dir/run.env"
+grep -q "^FINAL_HEAD=$(git -C "$worktree" rev-parse HEAD)$" "$run_dir/run.env"
+
+status_output="$(git -C "$worktree" status --short)"
+if [[ -n "$status_output" ]]; then
+  echo "worktree unexpectedly dirty:" >&2
+  printf '%s\n' "$status_output" >&2
+  exit 1
+fi
+
+echo "agent-project openclaw session wrapper test passed"