feat: add uipath-core and platform

Author: radu-mocanu

.github/labeler.yml

@@ -1,7 +1,15 @@
+test:uipath-langchain:
+  - changed-files:
+    - any-glob-to-any-file: ['packages/uipath/src/**/*.py']
+  - changed-files:
+    - any-glob-to-any-file: ['packages/uipath-platform/src/**/*.py']
+  - changed-files:
+    - any-glob-to-any-file: ['packages/uipath-core/src/**/*.py']
+
 test:uipath-llamaindex:
   - changed-files:
-    - any-glob-to-any-file: ['src/**/*.py']
+    - any-glob-to-any-file: ['packages/uipath/src/**/*.py']
 
-test:uipath-langchain:
+test:uipath-runtime:
   - changed-files:
-    - any-glob-to-any-file: ['src/**/*.py']
+    - any-glob-to-any-file: ['packages/uipath-core/src/**/*.py']

.github/scripts/detect_changed_packages.py

@@ -0,0 +1,162 @@
+#!/usr/bin/env python3
+"""Detect which packages have changed in a PR or push to main.
+
+Includes dependency-aware propagation: when a package changes, all
+downstream dependents are also included in the test list.
+"""
+
+import json
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+# Internal dependency graph: package -> packages that depend on it.
+# When a package changes, its dependents' tests also run.
+# Add new entries here as packages are added to the monorepo.
+# External dependents (uipath-langchain, uipath-runtime, etc.) are
+# handled separately via labeler.yml auto-labels.
+DEPENDENTS: dict[str, list[str]] = {
+    "uipath-core": ["uipath-platform", "uipath"],
+    "uipath-platform": ["uipath"],
+}
+
+
+def expand_with_dependents(changed: list[str], all_packages: list[str]) -> list[str]:
+    """Expand changed package list to include downstream dependents."""
+    expanded = set(changed)
+    for pkg in changed:
+        for dep in DEPENDENTS.get(pkg, []):
+            if dep in all_packages:
+                expanded.add(dep)
+    return sorted(expanded)
+
+
+def get_all_packages() -> list[str]:
+    """Get all packages in the monorepo."""
+    packages_dir = Path("packages")
+    packages = []
+
+    for item in packages_dir.iterdir():
+        if item.is_dir() and (item / "pyproject.toml").exists():
+            packages.append(item.name)
+
+    return sorted(packages)
+
+
+def get_changed_packages(base_sha: str, head_sha: str) -> list[str]:
+    """Get packages that have changed between two commits."""
+    try:
+        # Get changed files
+        result = subprocess.run(
+            ["git", "diff", "--name-only", f"{base_sha}...{head_sha}"],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+
+        changed_files = result.stdout.strip().split("\n")
+
+        # Extract package names from paths like "packages/uipath-llamaindex/..."
+        changed_packages = set()
+        for file_path in changed_files:
+            if file_path.startswith("packages/"):
+                parts = file_path.split("/")
+                if len(parts) >= 2:
+                    package_name = parts[1]
+                    # Verify it's a real package
+                    if (Path("packages") / package_name / "pyproject.toml").exists():
+                        changed_packages.add(package_name)
+
+        return sorted(changed_packages)
+
+    except subprocess.CalledProcessError as e:
+        print(f"Error running git diff: {e}", file=sys.stderr)
+        return []
+
+
+def get_changed_packages_auto() -> list[str]:
+    """Auto-detect changed packages using git."""
+    try:
+        # Try to detect changes against origin/main
+        result = subprocess.run(
+            ["git", "diff", "--name-only", "origin/main...HEAD"],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+
+        changed_files = result.stdout.strip().split("\n")
+
+        # Extract package names
+        changed_packages = set()
+        for file_path in changed_files:
+            if file_path.startswith("packages/"):
+                parts = file_path.split("/")
+                if len(parts) >= 2:
+                    package_name = parts[1]
+                    if (Path("packages") / package_name / "pyproject.toml").exists():
+                        changed_packages.add(package_name)
+
+        return sorted(changed_packages)
+
+    except (subprocess.CalledProcessError, Exception) as e:
+        print(f"Warning: Could not auto-detect changes: {e}", file=sys.stderr)
+        return []
+
+
+def main():
+    """Main entry point."""
+    event_name = os.getenv("GITHUB_EVENT_NAME", "")
+    base_sha = os.getenv("BASE_SHA", "")
+    head_sha = os.getenv("HEAD_SHA", "")
+
+    all_packages = get_all_packages()
+
+    # If we have explicit SHAs (from PR or push), detect changed packages
+    if base_sha and head_sha:
+        packages = get_changed_packages(base_sha, head_sha)
+        event_type = "pull request" if event_name == "pull_request" else "push"
+        print(f"{event_type.capitalize()} - detected {len(packages)} directly changed package(s):")
+        for pkg in packages:
+            print(f"  - {pkg}")
+
+    # workflow_call or missing context - try auto-detection
+    else:
+        print(f"Event: {event_name or 'workflow_call'} - attempting auto-detection")
+        packages = get_changed_packages_auto()
+
+        if packages:
+            print(f"Auto-detected {len(packages)} directly changed package(s):")
+            for pkg in packages:
+                print(f"  - {pkg}")
+        else:
+            # Fallback: test all packages
+            print("Could not detect changes - testing all packages")
+            packages = all_packages
+            for pkg in packages:
+                print(f"  - {pkg}")
+
+    # Expand with downstream dependents
+    expanded = expand_with_dependents(packages, all_packages)
+    added = sorted(set(expanded) - set(packages))
+    if added:
+        print(f"\nAdded {len(added)} dependent package(s):")
+        for pkg in added:
+            print(f"  - {pkg}")
+    packages = expanded
+
+    # Output as JSON for GitHub Actions
+    packages_json = json.dumps(packages)
+    print(f"\nPackages JSON: {packages_json}")
+
+    # Write to GitHub output
+    github_output = os.getenv("GITHUB_OUTPUT")
+    if github_output:
+        with open(github_output, "a") as f:
+            f.write(f"packages={packages_json}\n")
+            f.write(f"count={len(packages)}\n")
+
+
+if __name__ == "__main__":
+    main()

.github/workflows/cd.yml

@@ -6,24 +6,51 @@ on:
     branches:
       - main
     paths:
-      - pyproject.toml
+      - 'packages/*/pyproject.toml'
+      - '!packages/*/samples/**/pyproject.toml'
+      - '!packages/*/testcases/**/pyproject.toml'
+
+permissions:
+  contents: read
+  pull-requests: read
 
 jobs:
-  lint:
-    uses: ./.github/workflows/lint.yml
+  detect-changed-packages:
+    runs-on: ubuntu-latest
+    outputs:
+      packages: ${{ steps.detect.outputs.packages }}
+      count: ${{ steps.detect.outputs.count }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
-  test:
-    uses: ./.github/workflows/test.yml
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Detect changed packages
+        id: detect
+        env:
+          GITHUB_EVENT_NAME: ${{ github.event_name }}
+          BASE_SHA: ${{ github.event.before }}
+          HEAD_SHA: ${{ github.event.after }}
+        run: python .github/scripts/detect_changed_packages.py
 
   build:
-    name: Build
+    name: Build ${{ matrix.package }}
+    needs: detect-changed-packages
+    if: needs.detect-changed-packages.outputs.count > 0 && github.repository == 'UiPath/uipath-python'
     runs-on: ubuntu-latest
-
-    needs:
-      - lint
-      - test
-
-    if: ${{ github.repository == 'UiPath/uipath-python' }}
+    defaults:
+      run:
+        working-directory: packages/${{ matrix.package }}
+    strategy:
+      fail-fast: false
+      matrix:
+        package: ${{ fromJson(needs.detect-changed-packages.outputs.packages) }}
     permissions:
       contents: read
       actions: write
@@ -40,15 +67,17 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
-          python-version-file: ".python-version"
+          python-version-file: "packages/${{ matrix.package }}/.python-version"
 
       - name: Install dependencies
         run: uv sync --all-extras
 
       - name: Update AGENTS.md
+        if: matrix.package == 'uipath'
         run: uv run python scripts/update_agents_md.py
 
       - name: Replace connection string placeholder
+        if: matrix.package == 'uipath'
         run: |
           originalfile="src/uipath/telemetry/_constants.py"
           tmpfile=$(mktemp)
@@ -60,21 +89,23 @@ jobs:
           CONNECTION_STRING: ${{ secrets.APPLICATIONINSIGHTS_CONNECTION_STRING }}
 
       - name: Build
-        run: uv build
+        run: uv build --no-sources --package ${{ matrix.package }}
 
       - name: Upload artifacts
         uses: actions/upload-artifact@v4
         with:
-          name: release-dists
-          path: dist/
+          name: release-dists-${{ matrix.package }}
+          path: packages/${{ matrix.package }}/dist/
 
   pypi-publish:
-    name: Upload release to PyPI
+    name: Upload ${{ matrix.package }} to PyPI
+    needs: [detect-changed-packages, build]
     runs-on: ubuntu-latest
     environment: pypi
-
-    needs:
-      - build
+    strategy:
+      fail-fast: false
+      matrix:
+        package: ${{ fromJson(needs.detect-changed-packages.outputs.packages) }}
     permissions:
       contents: read
       id-token: write
@@ -83,7 +114,7 @@ jobs:
       - name: Retrieve release distributions
         uses: actions/download-artifact@v4
         with:
-          name: release-dists
+          name: release-dists-${{ matrix.package }}
           path: dist/
 
       - name: Publish package distributions to PyPI

.github/workflows/ci.yml

@@ -5,18 +5,23 @@ on:
     branches:
       - main
     paths-ignore:
-      - pyproject.toml
+      - packages/*/pyproject.toml
+      - '!packages/*/samples/**/pyproject.toml'
+      - '!packages/*/testcases/**/pyproject.toml'
   pull_request:
     branches:
       - main
 
+permissions:
+  contents: read
+
 jobs:
   commit-lint:
     if: ${{ github.event_name == 'pull_request' }}
     uses: ./.github/workflows/commitlint.yml
 
   lint:
-    uses: ./.github/workflows/lint.yml
+    uses: ./.github/workflows/lint-packages.yml
 
   test:
-    uses: ./.github/workflows/test.yml
+    uses: ./.github/workflows/test-packages.yml

.github/workflows/integration_tests.yml

@@ -1,4 +1,4 @@
-name: Integration testing
+name: uipath - Integration Tests
 
 on:
   push:
@@ -22,6 +22,7 @@ jobs:
 
     - name: Discover testcases
       id: discover
+      working-directory: packages/uipath
       run: |
         # Find all testcase folders (excluding common folders like README, etc.)
         testcase_dirs=$(find testcases -maxdepth 1 -type d -name "*-*" | sed 's|testcases/||' | sort)
@@ -54,6 +55,7 @@ jobs:
       uses: actions/checkout@v4
 
     - name: Install dependencies
+      working-directory: packages/uipath
       run: uv sync
 
     - name: Run testcase
@@ -68,7 +70,7 @@ jobs:
         TELEMETRY_CONNECTION_STRING: ${{ secrets.APPLICATIONINSIGHTS_CONNECTION_STRING }}
         APP_INSIGHTS_APP_ID: ${{ secrets.APP_INSIGHTS_APP_ID }}
         APP_INSIGHTS_API_KEY: ${{ secrets.APP_INSIGHTS_API_KEY }}
-      working-directory: testcases/${{ matrix.testcase }}
+      working-directory: packages/uipath/testcases/${{ matrix.testcase }}
       run: |
         # If any errors occur execution will stop with exit code
         set -e