Merge branch 'main' of github.com:mattsp1290/ag-ui into dart-sdk

Author: mattsp1290

.github/CODEOWNERS

@@ -1 +1,5 @@
 * @mme @ranst91 @ataibarkai @maxkorp @tylerslaton @NathanTarbert
+
+sdks/community/java @pascalwilbrink
+sdks/community/kotlin @contextablemark
+sdks/community/go @mattsp1290

.github/pull_request_template.md

@@ -0,0 +1,18 @@
+
+<!--
+
+**Please PLEASE reach out to us first before starting any significant work on new or existing features.**
+
+By the time you've gotten here, you're looking at creating a pull request so hopefully we're not too late.
+
+We love community contributions! That said, we want to make sure we're all on the same page before you start.
+Investing a lot of time and effort just to find out it doesn't align with the upstream project feels awful, and we don't want that to happen.
+It also helps to make sure the work you're planning isn't already in progress.
+
+As described in our contributing guide, please file an issue first: https://github.com/ag-ui-protocol/ag-ui/issues
+Or, reach out to us on Discord: https://discord.gg/Jd3FzfdJa8
+
+Take a look at the contributing guide:
+https://github.com/ag-ui-protocol/ag-ui/blob/main/CONTRIBUTING.md
+
+-->

.github/workflows/check-generated-files.yml

@@ -14,25 +14,33 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
 
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.13.1
+
       - name: Regenerate files.json
-        working-directory: typescript-sdk/apps/dojo
-        run: npm run generate-content-json
+        working-directory: apps/dojo
+        run: pnpm generate-content-json
 
       - name: Check files.json
-        working-directory: typescript-sdk/apps/dojo
+        working-directory: apps/dojo
         run: |
           if git diff --exit-code src/files.json > /dev/null; then
             echo "✅ No changes detected in dojo/src/files.json. Everything is up to date."
           else
             echo "❌ Detected changes in dojo/src/files.json."
             echo ""
-            echo "Please run \`(p)npm run generate-content-json\` in the typescript-sdk/apps/dojo folder and commit the changes."
+            echo "Please run \`(p)npm run generate-content-json\` in the apps/dojo folder and commit the changes."
             echo ""
             echo "The detected diff was as follows:"
             echo "::group::Diff for dojo/src/files.json"
             git diff src/files.json
             echo "::endgroup::"
             exit 1
           fi
-
-

.github/workflows/dojo-e2e.yml

@@ -14,6 +14,10 @@ jobs:
       fail-fast: false
       matrix:
         include:
+          - suite: a2a-middleware
+            test_path: tests/a2aMiddlewareTests
+            services: ["dojo","a2a-middleware"]
+            wait_on: http://localhost:9999,tcp:localhost:8011,tcp:localhost:8012,tcp:localhost:8013,tcp:localhost:8014
           - suite: adk-middleware
             test_path: tests/adkMiddlewareTests
             services: ["dojo","adk-middleware"]
@@ -66,10 +70,10 @@ jobs:
             test_path: tests/serverStarterAllFeaturesTests
             services: ["dojo","server-starter-all"]
             wait_on: http://localhost:9999,tcp:localhost:8001
-          - suite: vercel-ai-sdk
-            test_path: tests/vercelAISdkTests
-            services: ["dojo"]
-            wait_on: http://localhost:9999
+          # - suite: vercel-ai-sdk
+          #   test_path: tests/vercelAISdkTests
+          #   services: ["dojo"]
+          #   wait_on: http://localhost:9999
 
     steps:
     - name: Checkout code
@@ -123,32 +127,29 @@ jobs:
       uses: astral-sh/setup-uv@v6
 
     - name: Install dependencies
-      working-directory: typescript-sdk
       run: pnpm install --frozen-lockfile
 
     - name: Prepare dojo for e2e
-      working-directory: typescript-sdk/apps/dojo
+      working-directory: apps/dojo
       if: ${{ join(matrix.services, ',') != '' }}
       run: node ./scripts/prep-dojo-everything.js --only ${{ join(matrix.services, ',') }}
 
     - name: Install e2e dependencies
-      working-directory: typescript-sdk/apps/dojo/e2e
+      working-directory: apps/dojo/e2e
       run: |
         pnpm install
 
     - name: write langgraph env files
-      working-directory: typescript-sdk/integrations/langgraph
+      working-directory: integrations/langgraph
       env:
         OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
         LANGSMITH_API_KEY: ${{ secrets.LANGSMITH_API_KEY }}
       if: ${{ contains(join(matrix.services, ','), 'langgraph-fastapi') || contains(join(matrix.services, ','), 'langgraph-platform-python') || contains(join(matrix.services, ','), 'langgraph-platform-typescript') }}
       run: |
-        echo "OPENAI_API_KEY=${OPENAI_API_KEY}" > examples/python/.env
-        echo "LANGSMITH_API_KEY=${LANGSMITH_API_KEY}" >> examples/python/.env
-        echo "OPENAI_API_KEY=${OPENAI_API_KEY}" > examples/typescript/.env
-        echo "LANGSMITH_API_KEY=${LANGSMITH_API_KEY}" >> examples/typescript/.env
-        echo "OPENAI_API_KEY=${OPENAI_API_KEY}" > python/ag_ui_langgraph/.env
-        echo "LANGSMITH_API_KEY=${LANGSMITH_API_KEY}" >> python/ag_ui_langgraph/.env
+        echo "OPENAI_API_KEY=${OPENAI_API_KEY}" > python/examples/.env
+        echo "LANGSMITH_API_KEY=${LANGSMITH_API_KEY}" >> python/examples/.env
+        echo "OPENAI_API_KEY=${OPENAI_API_KEY}" > typescript/examples/.env
+        echo "LANGSMITH_API_KEY=${LANGSMITH_API_KEY}" >> typescript/examples/.env
 
     - name: Run dojo+agents
       uses: JarvusInnovations/background-action@v1
@@ -160,12 +161,12 @@ jobs:
       with:
         run: |
           node ../scripts/run-dojo-everything.js --only ${{ join(matrix.services, ',') }}
-        working-directory: typescript-sdk/apps/dojo/e2e
+        working-directory: apps/dojo/e2e
         wait-on: ${{ matrix.wait_on }}
         wait-for: 300000
 
     - name: Run tests – ${{ matrix.suite }}
-      working-directory: typescript-sdk/apps/dojo/e2e
+      working-directory: apps/dojo/e2e
       env:
         BASE_URL: http://localhost:9999
         PLAYWRIGHT_SUITE: ${{ matrix.suite }}
@@ -178,6 +179,6 @@ jobs:
       with:
         name: ${{ matrix.suite }}-playwright-traces
         path: |
-          typescript-sdk/apps/dojo/e2e/test-results/${{ matrix.suite }}/**/*
-          typescript-sdk/apps/dojo/e2e/playwright-report/**/*
+          apps/dojo/e2e/test-results/${{ matrix.suite }}/**/*
+          apps/dojo/e2e/playwright-report/**/*
         retention-days: 7

.github/workflows/test.yml

@@ -36,15 +36,15 @@ jobs:
 
     - name: Install dependencies
       if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
-      working-directory: python-sdk
+      working-directory: sdks/python
       run: poetry install --no-interaction --no-root
 
     - name: Install project
-      working-directory: python-sdk
+      working-directory: sdks/python
       run: poetry install --no-interaction
 
     - name: Run tests
-      working-directory: python-sdk
+      working-directory: sdks/python
       run: poetry run python -m unittest discover tests -v
 
   typescript:
@@ -58,7 +58,7 @@ jobs:
     - name: Set up Node.js
       uses: actions/setup-node@v4
       with:
-        node-version: '18'
+        node-version: '22'
 
     - name: Install protoc
       uses: arduino/setup-protoc@v3
@@ -80,34 +80,132 @@ jobs:
           ${{ runner.os }}-pnpm-store-
 
     - name: Install dependencies
-      working-directory: typescript-sdk
       run: pnpm install --frozen-lockfile
 
     - name: Test Build
-      working-directory: typescript-sdk
       run: pnpm run build
 
     - name: Run tests
-      working-directory: typescript-sdk
       run: pnpm run test
 
-  dart:
-    name: Dart SDK Tests
+  go:
+    name: Go SDK Tests
     runs-on: ubuntu-latest
 
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
 
-    - name: Set up Dart
-      uses: dart-lang/setup-dart@v1
+    - name: Set up Go
+      uses: actions/setup-go@v5
       with:
-        sdk: stable
+        go-version: '1.24.4'
 
-    - name: Install dependencies
-      working-directory: sdks/community/dart
-      run: dart pub get
+    - name: Setup Go module cache
+      uses: actions/cache@v4
+      with:
+        path: |
+          ~/go/pkg/mod
+          ~/.cache/go-build
+        key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
+        restore-keys: |
+          ${{ runner.os }}-go-
+
+    - name: Download dependencies
+      working-directory: sdks/community/go
+      run: go mod download
+
+    - name: Run tests
+      working-directory: sdks/community/go
+      run: go test ./... -v
+
+  kotlin:
+    name: Kotlin SDK Tests
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up JDK 21
+      uses: actions/setup-java@v4
+      with:
+        java-version: '21'
+        distribution: 'temurin'
+
+    - name: Setup Gradle
+      uses: gradle/gradle-build-action@v3
+
+    - name: Run JVM tests
+      working-directory: sdks/community/kotlin/library
+      run: ./gradlew jvmTest --no-daemon --stacktrace
+
+    - name: Parse test results
+      if: always()
+      working-directory: sdks/community/kotlin/library
+      run: |
+        echo "## Kotlin SDK Test Results Summary"
+        echo ""
+
+        total_tests=0
+        total_failures=0
+        total_errors=0
+
+        for module in core client tools; do
+          xml_dir="$module/build/test-results/jvmTest"
+
+          if [ -d "$xml_dir" ]; then
+            # Sum up test counts from all XML files in the directory
+            module_tests=$(find "$xml_dir" -name "*.xml" -exec grep -h '<testsuite' {} \; | grep -o 'tests="[0-9]*"' | sed 's/tests="\([0-9]*\)"/\1/' | awk '{sum += $1} END {print sum}')
+            module_failures=$(find "$xml_dir" -name "*.xml" -exec grep -h '<testsuite' {} \; | grep -o 'failures="[0-9]*"' | sed 's/failures="\([0-9]*\)"/\1/' | awk '{sum += $1} END {print sum}')
+            module_errors=$(find "$xml_dir" -name "*.xml" -exec grep -h '<testsuite' {} \; | grep -o 'errors="[0-9]*"' | sed 's/errors="\([0-9]*\)"/\1/' | awk '{sum += $1} END {print sum}')
+
+            # Default to 0 if empty
+            module_tests=${module_tests:-0}
+            module_failures=${module_failures:-0}
+            module_errors=${module_errors:-0}
+
+            if [ "$module_tests" -gt 0 ]; then
+              echo "✅ kotlin-$module: $module_tests tests, $module_failures failures, $module_errors errors"
+              total_tests=$((total_tests + module_tests))
+              total_failures=$((total_failures + module_failures))
+              total_errors=$((total_errors + module_errors))
+            fi
+          fi
+        done
+
+        echo ""
+        echo "---"
+        echo "### Overall Results: $total_tests tests, $total_failures failures, $total_errors errors"
+
+        if [ $total_failures -gt 0 ] || [ $total_errors -gt 0 ]; then
+          echo "❌ Some tests failed"
+          exit 1
+        elif [ $total_tests -eq 0 ]; then
+          echo "⚠️ No tests were found or executed"
+          exit 1
+        else
+          echo "✅ All $total_tests tests passed!"
+        fi
+
+  java:
+    name: Java SDK Tests
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: sdks/community/java
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Java
+      uses: actions/setup-java@v4
+      with:
+        distribution: 'temurin'
+        java-version: '17'
+        cache: 'maven'
 
     - name: Run tests
-      working-directory: sdks/community/dart
-      run: dart test --exclude-tags requires-server
+      run: mvn -B -ntp test