Merge pull request #169 from UiPath/fix/add_google_adk_integration

feat: add google adk integration

Author: cristipufu

.github/workflows/lint-packages.yml

@@ -157,6 +157,69 @@ jobs:
         working-directory: packages/uipath-openai-agents
         run: uv run ruff format --check .
 
+  lint-google-adk:
+    name: Lint uipath-google-adk
+    needs: detect-changed-packages
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check if package changed
+        id: check
+        run: |
+          if [[ "${{ contains(github.event.pull_request.labels.*.name, 'test-core-dev-version') }}" == "true" ]]; then
+            echo "skip=true" >> $GITHUB_OUTPUT
+            echo "reason=custom-version-testing" >> $GITHUB_OUTPUT
+          elif echo '${{ needs.detect-changed-packages.outputs.packages }}' | jq -e 'index("uipath-google-adk")' > /dev/null; then
+            echo "skip=false" >> $GITHUB_OUTPUT
+          else
+            echo "skip=true" >> $GITHUB_OUTPUT
+            echo "reason=no-changes" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Skip
+        if: steps.check.outputs.skip == 'true'
+        run: |
+          if [[ "${{ steps.check.outputs.reason }}" == "custom-version-testing" ]]; then
+            echo "Skipping - custom version testing enabled"
+          else
+            echo "Skipping - no changes to uipath-google-adk"
+          fi
+
+      - name: Checkout
+        if: steps.check.outputs.skip != 'true'
+        uses: actions/checkout@v4
+
+      - name: Setup uv
+        if: steps.check.outputs.skip != 'true'
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Setup Python
+        if: steps.check.outputs.skip != 'true'
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "packages/uipath-google-adk/.python-version"
+
+      - name: Install dependencies
+        if: steps.check.outputs.skip != 'true'
+        working-directory: packages/uipath-google-adk
+        run: uv sync --all-extras
+
+      - name: Check static types
+        if: steps.check.outputs.skip != 'true'
+        working-directory: packages/uipath-google-adk
+        run: uv run mypy --config-file pyproject.toml .
+
+      - name: Check linting
+        if: steps.check.outputs.skip != 'true'
+        working-directory: packages/uipath-google-adk
+        run: uv run ruff check .
+
+      - name: Check formatting
+        if: steps.check.outputs.skip != 'true'
+        working-directory: packages/uipath-google-adk
+        run: uv run ruff format --check .
+
   skip-lint:
     name: Skip Lint (Custom Version Testing)
     runs-on: ubuntu-latest

.github/workflows/publish-dev.yml

@@ -212,4 +212,4 @@ jobs:
       - name: Publish
         run: uv publish --index testpypi
         env:
-          UV_PUBLISH_TOKEN: ${{ matrix.package == 'uipath-openai-agents' && secrets.TEST_PYPI_TOKEN_OPENAI_AGENTS || secrets.TEST_PYPI_TOKEN }}
+          UV_PUBLISH_TOKEN: ${{ matrix.package == 'uipath-openai-agents' && secrets.TEST_PYPI_TOKEN_OPENAI_AGENTS || matrix.package == 'uipath-google-adk' && secrets.TEST_PYPI_TOKEN_GOOGLE_ADK || secrets.TEST_PYPI_TOKEN }}

.github/workflows/test-packages.yml

@@ -129,3 +129,52 @@ jobs:
         if: steps.check.outputs.skip != 'true'
         working-directory: packages/uipath-openai-agents
         run: uv run pytest
+
+  test-google-adk:
+    name: Test (uipath-google-adk, ${{ matrix.python-version }}, ${{ matrix.os }})
+    needs: detect-changed-packages
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+        os: [ubuntu-latest, windows-latest]
+    steps:
+      - name: Check if package changed
+        id: check
+        shell: bash
+        run: |
+          if echo '${{ needs.detect-changed-packages.outputs.packages }}' | jq -e 'index("uipath-google-adk")' > /dev/null; then
+            echo "skip=false" >> $GITHUB_OUTPUT
+          else
+            echo "skip=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Skip
+        if: steps.check.outputs.skip == 'true'
+        shell: bash
+        run: echo "Skipping - no changes to uipath-google-adk"
+
+      - name: Checkout
+        if: steps.check.outputs.skip != 'true'
+        uses: actions/checkout@v4
+
+      - name: Setup uv
+        if: steps.check.outputs.skip != 'true'
+        uses: astral-sh/setup-uv@v5
+
+      - name: Setup Python
+        if: steps.check.outputs.skip != 'true'
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        if: steps.check.outputs.skip != 'true'
+        working-directory: packages/uipath-google-adk
+        run: uv sync --all-extras --python ${{ matrix.python-version }}
+
+      - name: Run tests
+        if: steps.check.outputs.skip != 'true'
+        working-directory: packages/uipath-google-adk
+        run: uv run pytest

.gitignore

@@ -182,3 +182,11 @@ cython_debug/
 /.vscode/launch.json
 
 playground.py
+
+# Samples generated files
+**/samples/**/.agent/
+**/samples/**/.claude/
+**/samples/**/AGENTS.md
+**/samples/**/CLAUDE.md
+**/samples/**/bindings.json
+**/samples/**/entry-points.json

README.md

@@ -28,6 +28,17 @@ Build agents using the [OpenAI Agents SDK](https://github.com/openai/openai-agen
 - [Docs](https://uipath.github.io/uipath-python/openai-agents/quick_start/)
 - [Samples](packages/uipath-openai-agents/samples/)
 
+### Google ADK
+
+[![PyPI - Version](https://img.shields.io/pypi/v/uipath-google-adk)](https://pypi.org/project/uipath-google-adk/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/uipath-google-adk.svg)](https://pypi.org/project/uipath-google-adk/)
+
+Build agents using the [Google Agent Development Kit (ADK)](https://github.com/google/adk-python):
+
+- [README](packages/uipath-google-adk/README.md)
+- [Docs](https://uipath.github.io/uipath-python/google-adk/quick_start/)
+- [Samples](packages/uipath-google-adk/samples/)
+
 
 ## Structure
 
@@ -37,7 +48,8 @@ This repository is organized as a monorepo with multiple packages:
 uipath-integrations-python/
 └── packages/
     ├── uipath-llamaindex/      # LlamaIndex runtime
-    └── uipath-openai-agents/   # OpenAI Agents runtime
+    ├── uipath-openai-agents/   # OpenAI Agents runtime
+    └── uipath-google-adk/      # Google ADK runtime
 ```
 
 ## Development

packages/uipath-google-adk/.python-version

@@ -0,0 +1 @@
+3.11

packages/uipath-google-adk/README.md

@@ -0,0 +1,125 @@
+# UiPath Google ADK Python SDK
+
+[![PyPI - Version](https://img.shields.io/pypi/v/uipath-google-adk)](https://pypi.org/project/uipath-google-adk/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/uipath-google-adk.svg)](https://pypi.org/project/uipath-google-adk/)
+[![Python versions](https://img.shields.io/pypi/pyversions/uipath-google-adk.svg)](https://pypi.org/project/uipath-google-adk/)
+
+A Python SDK that enables developers to build and deploy Google ADK agents to the UiPath Cloud Platform. It provides programmatic interaction with UiPath Cloud Platform services.
+
+This package is an extension to the [UiPath Python SDK](https://github.com/UiPath/uipath-python) and implements the [UiPath Runtime Protocol](https://github.com/UiPath/uipath-runtime-python).
+
+Check out these [sample projects](https://github.com/UiPath/uipath-integrations-python/tree/main/packages/uipath-google-adk/samples) to see the SDK in action.
+
+## Requirements
+
+-   Python 3.11 or higher
+-   UiPath Automation Cloud account
+
+## Installation
+
+```bash
+pip install uipath-google-adk
+```
+
+using `uv`:
+
+```bash
+uv add uipath-google-adk
+```
+
+## Configuration
+
+### Environment Variables
+
+Create a `.env` file in your project root with the following variables:
+
+```
+UIPATH_URL=https://cloud.uipath.com/ACCOUNT_NAME/TENANT_NAME
+UIPATH_ACCESS_TOKEN=YOUR_TOKEN_HERE
+```
+
+## Command Line Interface (CLI)
+
+The SDK provides a command-line interface for creating, packaging, and deploying Google ADK Agents:
+
+### Authentication
+
+```bash
+uipath auth
+```
+
+This command opens a browser for authentication and creates/updates your `.env` file with the proper credentials.
+
+### Initialize a Project
+
+```bash
+uipath init
+```
+
+Running `uipath init` will process the agent definitions in the `google_adk.json` file and create the corresponding `entry-points.json` file needed for deployment.
+
+For more details on the configuration format, see the [UiPath configuration specifications](https://github.com/UiPath/uipath-python/blob/main/specs/README.md).
+
+### Debug a Project
+
+```bash
+uipath run AGENT [INPUT]
+```
+
+Executes the agent with the provided JSON input arguments.
+
+### Package a Project
+
+```bash
+uipath pack
+```
+
+Packages your project into a `.nupkg` file that can be deployed to UiPath.
+
+**Note:** Your `pyproject.toml` must include:
+
+-   A description field (avoid characters: &, <, >, ", ', ;)
+-   Author information
+
+Example:
+
+```toml
+description = "Your package description"
+authors = [{name = "Your Name", email = "your.email@example.com"}]
+```
+
+### Publish a Package
+
+```bash
+uipath publish
+```
+
+Publishes the most recently created package to your UiPath Orchestrator.
+
+## Project Structure
+
+To properly use the CLI for packaging and publishing, your project should include:
+
+-   A `pyproject.toml` file with project metadata
+-   A `google_adk.json` file with your agent definitions (e.g., `"agents": {"agent": "main.py:agent"}`)
+-   A `entry-points.json` file (generated by `uipath init`)
+-   A `bindings.json` file (generated by `uipath init`) to configure resource overrides
+-   Any Python files needed for your automation
+
+## Development
+
+### Developer Tools
+
+Check out [uipath-dev](https://github.com/uipath/uipath-dev-python) - an interactive terminal application for building, testing, and debugging UiPath Python runtimes, agents, and automation scripts.
+
+### Setting Up a Development Environment
+
+Please read our [contribution guidelines](https://github.com/UiPath/uipath-integrations-python/packages/uipath-google-adk/blob/main/CONTRIBUTING.md) before submitting a pull request.
+
+### Special Thanks
+
+A huge thank-you to the open-source community and the maintainers of the libraries that make this project possible:
+
+- [Google ADK](https://github.com/google/adk-python) for providing a powerful framework for building AI agents.
+- [OpenInference](https://github.com/Arize-ai/openinference) for observability and instrumentation support.
+- [Pydantic](https://github.com/pydantic/pydantic) for reliable, typed configuration and validation.