refactor: share docker e2e instance helpers

scripts/lib/docker-e2e-package.sh

@@ -60,5 +60,5 @@ docker_e2e_package_mount_args() {
 }
 
 docker_e2e_harness_mount_args() {
-  DOCKER_E2E_HARNESS_ARGS=(-v "$ROOT_DIR/scripts/e2e:/app/scripts/e2e:ro")
+  DOCKER_E2E_HARNESS_ARGS=(-v "$ROOT_DIR/scripts/e2e:/app/scripts/e2e:ro" -v "$ROOT_DIR/scripts/lib:/app/scripts/lib:ro")
 }

scripts/lib/openclaw-e2e-instance.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# Shared in-container lifecycle helpers for Docker/Bash E2E lanes.
+openclaw_e2e_eval_test_state_from_b64() { eval "$(printf '%s' "${1:?missing OpenClaw test-state script}" | base64 -d)"; }
+openclaw_e2e_resolve_entrypoint() {
+  local entry
+  for entry in dist/index.mjs dist/index.js; do
+    [ -f "$entry" ] && { printf '%s\n' "$entry"; return 0; }
+  done
+  echo "OpenClaw entrypoint not found under dist/" >&2
+  return 1
+}
+openclaw_e2e_stop_process() {
+  local pid="${1:-}" _
+  [ -n "$pid" ] || return 0
+  kill "$pid" >/dev/null 2>&1 || true
+  for _ in $(seq 1 40); do
+    ! kill -0 "$pid" >/dev/null 2>&1 && { wait "$pid" >/dev/null 2>&1 || true; return 0; }
+    sleep 0.25
+  done
+  kill -9 "$pid" >/dev/null 2>&1 || true
+  wait "$pid" >/dev/null 2>&1 || true
+}
+openclaw_e2e_start_mock_openai() { MOCK_PORT="$1" node scripts/e2e/mock-openai-server.mjs >"$2" 2>&1 & printf '%s\n' "$!"; }
+openclaw_e2e_wait_mock_openai() {
+  local port="$1" attempts="${2:-80}" _
+  local probe="fetch('http://127.0.0.1:' + process.argv[1] + '/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"
+  for _ in $(seq 1 "$attempts"); do
+    node -e "$probe" "$port" && return 0
+    sleep 0.1
+  done
+  node -e "$probe" "$port"
+}
+openclaw_e2e_start_gateway() { node "$1" gateway --port "$2" --bind loopback --allow-unconfigured >"$3" 2>&1 & printf '%s\n' "$!"; }
+openclaw_e2e_wait_gateway_ready() {
+  local pid="$1" log="$2" attempts="${3:-300}" _
+  for _ in $(seq 1 "$attempts"); do
+    ! kill -0 "$pid" >/dev/null 2>&1 && {
+      echo "Gateway exited before becoming ready"
+      wait "$pid" || true
+      tail -n 120 "$log" 2>/dev/null || true
+      return 1
+    }
+    grep -q '\[gateway\] ready' "$log" 2>/dev/null && return 0
+    sleep 0.25
+  done
+  echo "Gateway did not become ready"
+  tail -n 120 "$log" 2>/dev/null || true
+  return 1
+}
+openclaw_e2e_dump_logs() {
+  local path
+  for path in "$@"; do
+    [ -f "$path" ] || continue
+    echo "--- $path ---"; tail -n "${OPENCLAW_E2E_LOG_TAIL_LINES:-120}" "$path" || true
+  done
+}