Add E2E scenario tests/examples for all SDK languages

.github/workflows/scenario-builds.yml

@@ -0,0 +1,183 @@
+name: "Scenario Build Verification"
+
+on:
+  pull_request:
+    paths:
+      - "test/scenarios/**"
+      - "nodejs/src/**"
+      - "python/copilot/**"
+      - "go/**/*.go"
+      - "dotnet/src/**"
+      - ".github/workflows/scenario-builds.yml"
+  push:
+    branches:
+      - main
+    paths:
+      - "test/scenarios/**"
+      - ".github/workflows/scenario-builds.yml"
+  workflow_dispatch:
+  merge_group:
+
+permissions:
+  contents: read
+
+jobs:
+  # ── TypeScript ──────────────────────────────────────────────────────
+  build-typescript:
+    name: "TypeScript scenarios"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 22
+
+      - uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-npm-scenarios-${{ hashFiles('test/scenarios/**/package.json') }}
+          restore-keys: |
+            ${{ runner.os }}-npm-scenarios-
+
+      # Build the SDK so local file: references resolve
+      - name: Build SDK
+        working-directory: nodejs
+        run: npm ci --ignore-scripts
+
+      - name: Build all TypeScript scenarios
+        run: |
+          PASS=0; FAIL=0; FAILURES=""
+          for dir in $(find test/scenarios -path '*/typescript/package.json' -exec dirname {} \; | sort); do
+            scenario="${dir#test/scenarios/}"
+            echo "::group::$scenario"
+            if (cd "$dir" && npm install --ignore-scripts 2>&1); then
+              echo "✅ $scenario"
+              PASS=$((PASS + 1))
+            else
+              echo "❌ $scenario"
+              FAIL=$((FAIL + 1))
+              FAILURES="$FAILURES\n  $scenario"
+            fi
+            echo "::endgroup::"
+          done
+          echo ""
+          echo "TypeScript builds: $PASS passed, $FAIL failed"
+          if [ "$FAIL" -gt 0 ]; then
+            echo -e "Failures:$FAILURES"
+            exit 1
+          fi
+
+  # ── Python ──────────────────────────────────────────────────────────
+  build-python:
+    name: "Python scenarios"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Syntax-check all Python scenarios
+        run: |
+          PASS=0; FAIL=0; FAILURES=""
+          for main in $(find test/scenarios -path '*/python/main.py' | sort); do
+            dir=$(dirname "$main")
+            scenario="${dir#test/scenarios/}"
+            echo "::group::$scenario"
+            if python3 -c "import ast, sys; ast.parse(open('$main').read()); print('syntax ok')" 2>&1; then
+              echo "✅ $scenario"
+              PASS=$((PASS + 1))
+            else
+              echo "❌ $scenario"
+              FAIL=$((FAIL + 1))
+              FAILURES="$FAILURES\n  $scenario"
+            fi
+            echo "::endgroup::"
+          done
+          echo ""
+          echo "Python builds: $PASS passed, $FAIL failed"
+          if [ "$FAIL" -gt 0 ]; then
+            echo -e "Failures:$FAILURES"
+            exit 1
+          fi
+
+  # ── Go ──────────────────────────────────────────────────────────────
+  build-go:
+    name: "Go scenarios"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-go@v6
+        with:
+          go-version: "1.24"
+          cache: true
+          cache-dependency-path: test/scenarios/**/go.sum
+
+      - name: Build all Go scenarios
+        run: |
+          PASS=0; FAIL=0; FAILURES=""
+          for mod in $(find test/scenarios -path '*/go/go.mod' | sort); do
+            dir=$(dirname "$mod")
+            scenario="${dir#test/scenarios/}"
+            echo "::group::$scenario"
+            if (cd "$dir" && go build ./... 2>&1); then
+              echo "✅ $scenario"
+              PASS=$((PASS + 1))
+            else
+              echo "❌ $scenario"
+              FAIL=$((FAIL + 1))
+              FAILURES="$FAILURES\n  $scenario"
+            fi
+            echo "::endgroup::"
+          done
+          echo ""
+          echo "Go builds: $PASS passed, $FAIL failed"
+          if [ "$FAIL" -gt 0 ]; then
+            echo -e "Failures:$FAILURES"
+            exit 1
+          fi
+
+  # ── C# ─────────────────────────────────────────────────────────────
+  build-csharp:
+    name: "C# scenarios"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: "8.0.x"
+
+      - uses: actions/cache@v4
+        with:
+          path: ~/.nuget/packages
+          key: ${{ runner.os }}-nuget-scenarios-${{ hashFiles('test/scenarios/**/*.csproj') }}
+          restore-keys: |
+            ${{ runner.os }}-nuget-scenarios-
+
+      - name: Build all C# scenarios
+        run: |
+          PASS=0; FAIL=0; FAILURES=""
+          for proj in $(find test/scenarios -name '*.csproj' | sort); do
+            dir=$(dirname "$proj")
+            scenario="${dir#test/scenarios/}"
+            echo "::group::$scenario"
+            if (cd "$dir" && dotnet build --nologo 2>&1); then
+              echo "✅ $scenario"
+              PASS=$((PASS + 1))
+            else
+              echo "❌ $scenario"
+              FAIL=$((FAIL + 1))
+              FAILURES="$FAILURES\n  $scenario"
+            fi
+            echo "::endgroup::"
+          done
+          echo ""
+          echo "C# builds: $PASS passed, $FAIL failed"
+          if [ "$FAIL" -gt 0 ]; then
+            echo -e "Failures:$FAILURES"
+            exit 1
+          fi

.gitignore

@@ -1,3 +1,4 @@
 
 # Documentation validation output
 docs/.validation/
+.DS_Store

justfile

@@ -117,3 +117,112 @@ validate-docs-go:
 validate-docs-cs:
     @echo "=== Validating C# documentation ==="
     @cd scripts/docs-validation && npm run validate:cs
+
+# Build all scenario samples (all languages)
+scenario-build:
+    #!/usr/bin/env bash
+    set -euo pipefail
+    echo "=== Building all scenario samples ==="
+    TOTAL=0; PASS=0; FAIL=0
+
+    build_lang() {
+      local lang="$1" find_expr="$2" build_cmd="$3"
+      echo ""
+      echo "── $lang ──"
+      while IFS= read -r target; do
+        [ -z "$target" ] && continue
+        dir=$(dirname "$target")
+        scenario="${dir#test/scenarios/}"
+        TOTAL=$((TOTAL + 1))
+        if (cd "$dir" && eval "$build_cmd" >/dev/null 2>&1); then
+          printf "  ✅ %s\n" "$scenario"
+          PASS=$((PASS + 1))
+        else
+          printf "  ❌ %s\n" "$scenario"
+          FAIL=$((FAIL + 1))
+        fi
+      done < <(find test/scenarios $find_expr | sort)
+    }
+
+    # TypeScript: npm install
+    (cd nodejs && npm ci --ignore-scripts --silent 2>/dev/null) || true
+    build_lang "TypeScript" "-path '*/typescript/package.json'" "npm install --ignore-scripts"
+
+    # Python: syntax check
+    build_lang "Python" "-path '*/python/main.py'" "python3 -c \"import ast; ast.parse(open('main.py').read())\""
+
+    # Go: go build
+    build_lang "Go" "-path '*/go/go.mod'" "go build ./..."
+
+    # C#: dotnet build
+    build_lang "C#" "-name '*.csproj' -path '*/csharp/*'" "dotnet build --nologo -v quiet"
+
+    echo ""
+    echo "══════════════════════════════════════"
+    echo " Scenario build summary: $PASS passed, $FAIL failed (of $TOTAL)"
+    echo "══════════════════════════════════════"
+    [ "$FAIL" -eq 0 ]
+
+# Run the full scenario verify orchestrator (build + E2E, needs real CLI)
+scenario-verify:
+    @echo "=== Running scenario verification ==="
+    @bash test/scenarios/verify.sh
+
+# Build scenarios for a single language (typescript, python, go, csharp)
+scenario-build-lang LANG:
+    #!/usr/bin/env bash
+    set -euo pipefail
+    echo "=== Building {{LANG}} scenarios ==="
+    PASS=0; FAIL=0
+
+    case "{{LANG}}" in
+      typescript)
+        (cd nodejs && npm ci --ignore-scripts --silent 2>/dev/null) || true
+        for target in $(find test/scenarios -path '*/typescript/package.json' | sort); do
+          dir=$(dirname "$target"); scenario="${dir#test/scenarios/}"
+          if (cd "$dir" && npm install --ignore-scripts >/dev/null 2>&1); then
+            printf "  ✅ %s\n" "$scenario"; PASS=$((PASS + 1))
+          else
+            printf "  ❌ %s\n" "$scenario"; FAIL=$((FAIL + 1))
+          fi
+        done
+        ;;
+      python)
+        for target in $(find test/scenarios -path '*/python/main.py' | sort); do
+          dir=$(dirname "$target"); scenario="${dir#test/scenarios/}"
+          if python3 -c "import ast; ast.parse(open('$target').read())" 2>/dev/null; then
+            printf "  ✅ %s\n" "$scenario"; PASS=$((PASS + 1))
+          else
+            printf "  ❌ %s\n" "$scenario"; FAIL=$((FAIL + 1))
+          fi
+        done
+        ;;
+      go)
+        for target in $(find test/scenarios -path '*/go/go.mod' | sort); do
+          dir=$(dirname "$target"); scenario="${dir#test/scenarios/}"
+          if (cd "$dir" && go build ./... >/dev/null 2>&1); then
+            printf "  ✅ %s\n" "$scenario"; PASS=$((PASS + 1))
+          else
+            printf "  ❌ %s\n" "$scenario"; FAIL=$((FAIL + 1))
+          fi
+        done
+        ;;
+      csharp)
+        for target in $(find test/scenarios -name '*.csproj' -path '*/csharp/*' | sort); do
+          dir=$(dirname "$target"); scenario="${dir#test/scenarios/}"
+          if (cd "$dir" && dotnet build --nologo -v quiet >/dev/null 2>&1); then
+            printf "  ✅ %s\n" "$scenario"; PASS=$((PASS + 1))
+          else
+            printf "  ❌ %s\n" "$scenario"; FAIL=$((FAIL + 1))
+          fi
+        done
+        ;;
+      *)
+        echo "Unknown language: {{LANG}}. Use: typescript, python, go, csharp"
+        exit 1
+        ;;
+    esac
+
+    echo ""
+    echo "{{LANG}} scenarios: $PASS passed, $FAIL failed"
+    [ "$FAIL" -eq 0 ]

test/scenarios/.gitignore

@@ -0,0 +1,84 @@
+# Dependencies
+node_modules/
+.venv/
+vendor/
+
+# E2E run artifacts (agents may create files during verify.sh runs)
+**/sessions/**/plan.md
+**/tools/**/plan.md
+**/callbacks/**/plan.md
+**/prompts/**/plan.md
+
+# Build output
+dist/
+target/
+build/
+*.exe
+*.dll
+*.so
+*.dylib
+
+# Go
+*.test
+fully-bundled-go
+app-direct-server-go
+container-proxy-go
+container-relay-go
+app-backend-to-server-go
+custom-agents-go
+mcp-servers-go
+no-tools-go
+virtual-filesystem-go
+system-message-go
+skills-go
+streaming-go
+attachments-go
+tool-filtering-go
+permissions-go
+hooks-go
+user-input-go
+concurrent-sessions-go
+session-resume-go
+stdio-go
+tcp-go
+gh-app-go
+cli-preset-go
+filesystem-preset-go
+minimal-preset-go
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+*.egg
+.eggs/
+
+# TypeScript
+*.tsbuildinfo
+package-lock.json
+
+# C# / .NET
+bin/
+obj/
+*.csproj.nuget.*
+
+# IDE / OS
+.DS_Store
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Multi-user scenario temp directories
+**/sessions/multi-user-long-lived/tmp/
+
+# Logs
+*.log
+npm-debug.log*
+infinite-sessions-go
+reasoning-effort-go
+reconnect-go
+byok-openai-go
+token-sources-go