|
| 1 | +#!/usr/bin/env bash |
| 2 | +# Run the Python reference seller through the AdCP media_buy_seller storyboard. |
| 3 | +# |
| 4 | +# Required runner input: set exactly one of these modes. |
| 5 | +# ADCP_SDK_VERSION=7.10.2 Install published @adcp/sdk from npm. |
| 6 | +# ADCP_SDK_TARBALL=/tmp/sdk.tgz Install a candidate @adcp/sdk tarball. |
| 7 | +# ADCP_RUNNER_BIN=/path/to/adcp Use a preinstalled storyboard runner binary. |
| 8 | +# |
| 9 | +# Optional inputs: |
| 10 | +# ADCP_PORT=3001 |
| 11 | +# STORYBOARD_RESULT_PATH=storyboard-result.json |
| 12 | +# PYTHON=python3 |
| 13 | +# ADCP_PYTHON_VENV=.context/storyboard-reference-seller-venv |
| 14 | +# ADCP_SDK_ROOT=/path/to/@adcp/sdk |
| 15 | +# |
| 16 | +# The script assumes it is running from an adcp-client-python checkout, |
| 17 | +# installs the Python dependencies needed by examples/seller_agent.py, |
| 18 | +# boots the seller, writes the storyboard JSON result, and exits non-zero |
| 19 | +# unless overall_status is "passing" and controller_detected is true. |
| 20 | +set -euo pipefail |
| 21 | + |
| 22 | +ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)" |
| 23 | +cd "$ROOT" |
| 24 | + |
| 25 | +ADCP_PORT="${ADCP_PORT:-3001}" |
| 26 | +STORYBOARD_RESULT_PATH="${STORYBOARD_RESULT_PATH:-storyboard-result.json}" |
| 27 | +PYTHON="${PYTHON:-python3}" |
| 28 | +ADCP_PYTHON_VENV="${ADCP_PYTHON_VENV:-$ROOT/.context/storyboard-reference-seller-venv}" |
| 29 | +SELLER_LOG_PATH="${SELLER_LOG_PATH:-/tmp/adcp-reference-seller.log}" |
| 30 | + |
| 31 | +ADCP_RUNNER_BIN="${ADCP_RUNNER_BIN:-}" |
| 32 | +ADCP_SDK_VERSION="${ADCP_SDK_VERSION:-}" |
| 33 | +ADCP_SDK_TARBALL="${ADCP_SDK_TARBALL:-}" |
| 34 | +ADCP_SDK_ROOT="${ADCP_SDK_ROOT:-}" |
| 35 | + |
| 36 | +fail() { |
| 37 | + echo "ERROR: $*" >&2 |
| 38 | + exit 1 |
| 39 | +} |
| 40 | + |
| 41 | +runner_modes=0 |
| 42 | +[[ -n "$ADCP_RUNNER_BIN" ]] && runner_modes=$((runner_modes + 1)) |
| 43 | +[[ -n "$ADCP_SDK_TARBALL" ]] && runner_modes=$((runner_modes + 1)) |
| 44 | +[[ -n "$ADCP_SDK_VERSION" ]] && runner_modes=$((runner_modes + 1)) |
| 45 | +[[ "$runner_modes" -eq 1 ]] || fail "set exactly one of ADCP_RUNNER_BIN, ADCP_SDK_TARBALL, or ADCP_SDK_VERSION" |
| 46 | + |
| 47 | +require_command() { |
| 48 | + command -v "$1" >/dev/null 2>&1 || fail "required command not found: $1" |
| 49 | +} |
| 50 | + |
| 51 | +vendor_sdk_fixtures() { |
| 52 | + local sdk_root="$1" |
| 53 | + |
| 54 | + if [[ -z "$sdk_root" ]]; then |
| 55 | + echo "No @adcp/sdk root detected; skipping SDK fixture vendoring." |
| 56 | + return 0 |
| 57 | + fi |
| 58 | + if [[ ! -d "$sdk_root" ]]; then |
| 59 | + echo "@adcp/sdk root not found at $sdk_root; skipping SDK fixture vendoring." |
| 60 | + return 0 |
| 61 | + fi |
| 62 | + |
| 63 | + echo "Vendoring storyboard fixtures into $sdk_root" |
| 64 | + mkdir -p "$sdk_root/test/lib/v2-projection-fixtures" |
| 65 | + cp tests/fixtures/aao-reference-formats.json \ |
| 66 | + "$sdk_root/test/lib/v2-projection-fixtures/aao-reference-formats.json" |
| 67 | + mkdir -p "$sdk_root/schemas/cache/3.1.0-beta.2/registries" |
| 68 | + cp tests/fixtures/v1-canonical-mapping.json \ |
| 69 | + "$sdk_root/schemas/cache/3.1.0-beta.2/registries/v1-canonical-mapping.json" |
| 70 | +} |
| 71 | + |
| 72 | +detect_global_sdk_root() { |
| 73 | + require_command npm |
| 74 | + local npm_root |
| 75 | + npm_root="$(npm root -g)" |
| 76 | + local sdk_root="$npm_root/@adcp/sdk" |
| 77 | + [[ -d "$sdk_root" ]] && printf '%s\n' "$sdk_root" |
| 78 | +} |
| 79 | + |
| 80 | +install_or_select_runner() { |
| 81 | + if [[ -n "$ADCP_RUNNER_BIN" ]]; then |
| 82 | + command -v "$ADCP_RUNNER_BIN" >/dev/null 2>&1 || [[ -x "$ADCP_RUNNER_BIN" ]] || \ |
| 83 | + fail "ADCP_RUNNER_BIN is not executable or on PATH: $ADCP_RUNNER_BIN" |
| 84 | + echo "Using preinstalled storyboard runner: $ADCP_RUNNER_BIN" |
| 85 | + if [[ -z "$ADCP_SDK_ROOT" ]] && command -v npm >/dev/null 2>&1; then |
| 86 | + ADCP_SDK_ROOT="$(detect_global_sdk_root || true)" |
| 87 | + fi |
| 88 | + elif [[ -n "$ADCP_SDK_TARBALL" ]]; then |
| 89 | + require_command npm |
| 90 | + [[ -f "$ADCP_SDK_TARBALL" ]] || fail "ADCP_SDK_TARBALL not found: $ADCP_SDK_TARBALL" |
| 91 | + echo "Installing candidate @adcp/sdk tarball: $ADCP_SDK_TARBALL" |
| 92 | + npm install -g "$ADCP_SDK_TARBALL" |
| 93 | + ADCP_RUNNER_BIN="adcp" |
| 94 | + ADCP_SDK_ROOT="${ADCP_SDK_ROOT:-$(detect_global_sdk_root || true)}" |
| 95 | + else |
| 96 | + require_command npm |
| 97 | + echo "Installing published @adcp/sdk@$ADCP_SDK_VERSION" |
| 98 | + npm install -g "@adcp/sdk@$ADCP_SDK_VERSION" |
| 99 | + ADCP_RUNNER_BIN="adcp" |
| 100 | + ADCP_SDK_ROOT="${ADCP_SDK_ROOT:-$(detect_global_sdk_root || true)}" |
| 101 | + fi |
| 102 | + |
| 103 | + "$ADCP_RUNNER_BIN" --version |
| 104 | + vendor_sdk_fixtures "$ADCP_SDK_ROOT" |
| 105 | +} |
| 106 | + |
| 107 | +install_python_dependencies() { |
| 108 | + if "$PYTHON" - <<'PY' >/dev/null 2>&1 |
| 109 | +import sys |
| 110 | +raise SystemExit(0 if sys.prefix != sys.base_prefix else 1) |
| 111 | +PY |
| 112 | + then |
| 113 | + echo "Using active Python virtual environment: $PYTHON" |
| 114 | + else |
| 115 | + if [[ ! -x "$ADCP_PYTHON_VENV/bin/python" ]]; then |
| 116 | + echo "Creating Python virtual environment: $ADCP_PYTHON_VENV" |
| 117 | + "$PYTHON" -m venv "$ADCP_PYTHON_VENV" |
| 118 | + else |
| 119 | + echo "Using Python virtual environment: $ADCP_PYTHON_VENV" |
| 120 | + fi |
| 121 | + PYTHON="$ADCP_PYTHON_VENV/bin/python" |
| 122 | + fi |
| 123 | + |
| 124 | + echo "Installing Python dependencies" |
| 125 | + "$PYTHON" -m pip install --upgrade pip |
| 126 | + "$PYTHON" -m pip install -e ".[dev]" |
| 127 | +} |
| 128 | + |
| 129 | +wait_for_seller() { |
| 130 | + local pid="$1" |
| 131 | + local url="http://127.0.0.1:${ADCP_PORT}/mcp" |
| 132 | + |
| 133 | + for i in $(seq 1 60); do |
| 134 | + local http_code |
| 135 | + http_code=$(curl -s -o /dev/null -w "%{http_code}" --max-time 1 "$url" 2>/dev/null) || http_code="000" |
| 136 | + if [[ "$http_code" != "000" ]]; then |
| 137 | + echo "Seller agent ready (HTTP ${http_code}, pid ${pid})" |
| 138 | + return 0 |
| 139 | + fi |
| 140 | + if ! kill -0 "$pid" 2>/dev/null; then |
| 141 | + echo "Seller agent process died during startup" |
| 142 | + tail -n 80 "$SELLER_LOG_PATH" 2>/dev/null || true |
| 143 | + return 1 |
| 144 | + fi |
| 145 | + if [[ "$i" -eq 60 ]]; then |
| 146 | + echo "Seller agent failed to start within 30s" |
| 147 | + tail -n 80 "$SELLER_LOG_PATH" 2>/dev/null || true |
| 148 | + return 1 |
| 149 | + fi |
| 150 | + sleep 0.5 |
| 151 | + done |
| 152 | +} |
| 153 | + |
| 154 | +assert_storyboard_passed() { |
| 155 | + "$PYTHON" - "$STORYBOARD_RESULT_PATH" <<'PY' |
| 156 | +import json |
| 157 | +import pathlib |
| 158 | +import sys |
| 159 | +
|
| 160 | +path = pathlib.Path(sys.argv[1]) |
| 161 | +if not path.exists() or path.stat().st_size == 0: |
| 162 | + print(f"{path} missing or empty; runner produced no output") |
| 163 | + sys.exit(1) |
| 164 | +
|
| 165 | +with path.open() as f: |
| 166 | + doc = json.load(f) |
| 167 | +
|
| 168 | +if doc.get("overall_status") != "passing": |
| 169 | + print(json.dumps(doc, indent=2)) |
| 170 | + sys.exit(1) |
| 171 | +
|
| 172 | +if not doc.get("controller_detected"): |
| 173 | + print("controller_detected was false; check DemoStore overrides (see #304)") |
| 174 | + sys.exit(1) |
| 175 | +
|
| 176 | +summary = doc.get("summary") or {} |
| 177 | +print("Storyboard passing.") |
| 178 | +if summary: |
| 179 | + print("summary:", json.dumps(summary, sort_keys=True)) |
| 180 | +PY |
| 181 | +} |
| 182 | + |
| 183 | +cleanup() { |
| 184 | + if [[ -n "${SELLER_PID:-}" ]]; then |
| 185 | + kill "$SELLER_PID" 2>/dev/null || true |
| 186 | + wait "$SELLER_PID" 2>/dev/null || true |
| 187 | + fi |
| 188 | +} |
| 189 | +trap cleanup EXIT |
| 190 | + |
| 191 | +install_or_select_runner |
| 192 | +install_python_dependencies |
| 193 | + |
| 194 | +mkdir -p "$(dirname "$STORYBOARD_RESULT_PATH")" |
| 195 | +echo "Starting examples/seller_agent.py on port $ADCP_PORT" |
| 196 | +ADCP_PORT="$ADCP_PORT" "$PYTHON" examples/seller_agent.py >"$SELLER_LOG_PATH" 2>&1 & |
| 197 | +SELLER_PID=$! |
| 198 | +wait_for_seller "$SELLER_PID" |
| 199 | + |
| 200 | +echo "Running media_buy_seller storyboard" |
| 201 | +set +e |
| 202 | +"$ADCP_RUNNER_BIN" storyboard run \ |
| 203 | + "http://127.0.0.1:${ADCP_PORT}/mcp" media_buy_seller \ |
| 204 | + --json --allow-http \ |
| 205 | + >"$STORYBOARD_RESULT_PATH" |
| 206 | +RUNNER_STATUS=$? |
| 207 | +set -e |
| 208 | + |
| 209 | +if [[ "$RUNNER_STATUS" -ne 0 ]]; then |
| 210 | + echo "Storyboard runner exited with status $RUNNER_STATUS" |
| 211 | + [[ -s "$STORYBOARD_RESULT_PATH" ]] && cat "$STORYBOARD_RESULT_PATH" |
| 212 | + exit "$RUNNER_STATUS" |
| 213 | +fi |
| 214 | + |
| 215 | +assert_storyboard_passed |
0 commit comments