uipath-llm-client 1.0.0__tar.gz

uipath_llm_client-1.0.0/.env.example

@@ -0,0 +1,60 @@
+# =============================================================================
+# UiPath LLM Client Configuration
+# =============================================================================
+# Copy this file to .env and fill in your values.
+# The client supports two backends: AgentHub (default) and LLMGateway.
+
+# -----------------------------------------------------------------------------
+# Backend Selection
+# -----------------------------------------------------------------------------
+# Choose which backend to use: "agenthub" (default) or "llmgateway"
+UIPATH_LLM_BACKEND="agenthub"
+
+# =============================================================================
+# AGENTHUB BACKEND SETTINGS
+# =============================================================================
+# AgentHub uses the UiPath CLI for authentication by default.
+# Run `uv run uipath auth login` to authenticate interactively.
+# Alternatively, set the environment variables below.
+
+# Environment selection: "cloud", "staging", or "alpha" (default: None)
+UIPATH_ENVIRONMENT=""
+
+# Core settings (populated automatically by CLI auth, or set manually)
+UIPATH_URL=""
+UIPATH_ORGANIZATION_ID=""
+UIPATH_TENANT_ID=""
+
+# Access token (short-lived, populated by CLI auth)
+# If not using CLI auth, provide this directly or use S2S credentials below
+UIPATH_ACCESS_TOKEN=""
+
+# S2S Authentication for AgentHub (alternative to CLI/access token)
+UIPATH_CLIENT_ID=""
+UIPATH_CLIENT_SECRET=""
+UIPATH_CLIENT_SCOPE=""  # Optional: custom OAuth scope
+
+# =============================================================================
+# LLMGATEWAY BACKEND SETTINGS
+# =============================================================================
+# To use LLMGateway, set UIPATH_LLM_BACKEND="llmgateway" above.
+
+# Required settings
+LLMGW_URL=""
+LLMGW_SEMANTIC_ORG_ID=""
+LLMGW_SEMANTIC_TENANT_ID=""
+LLMGW_REQUESTING_PRODUCT=""
+LLMGW_REQUESTING_FEATURE=""
+
+# Authentication (choose one method)
+# Option 1: Access token (short-lived)
+LLMGW_ACCESS_TOKEN=""
+
+# Option 2: S2S Authentication (recommended for production)
+LLMGW_CLIENT_ID=""
+LLMGW_CLIENT_SECRET=""
+
+# Optional tracking and tracing
+LLMGW_SEMANTIC_USER_ID=""
+LLMGW_ACTION_ID=""
+LLMGW_ADDITIONAL_HEADERS=""

uipath_llm_client-1.0.0/.gitattributes

@@ -0,0 +1 @@
+tests/cassettes/** filter=lfs diff=lfs merge=lfs -text

uipath_llm_client-1.0.0/.github/workflows/cd-langchain.yml

@@ -0,0 +1,51 @@
+name: Publish uipath-langchain-client to PyPI
+
+on:
+  push:
+    tags:
+      # Publish on any tag starting with `langchain-v`, e.g., langchain-v1.0.0
+      - langchain-v*
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build package
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9.27"
+          enable-cache: true
+
+      - name: "Set up Python"
+        uses: actions/setup-python@v6
+        with:
+          python-version-file: ".python-version"
+      
+      - name: "Install dependencies"
+        run: uv sync --dev --all-extras --locked
+
+      - name: Build package
+        run: uv build --package uipath-langchain-client
+
+      - name: Smoke test (wheel with all extras)
+        run: |
+          WHEEL=$(ls dist/*.whl)
+          uv run --isolated --no-project --with "${WHEEL}[all]" tests/langchain/langchain_smoke_test.py
+
+      - name: Smoke test (source distribution with all extras)
+        run: |
+          SDIST=$(ls dist/*.tar.gz)
+          uv run --isolated --no-project --with "${SDIST}[all]" tests/langchain/langchain_smoke_test.py
+
+      - name: Publish package
+        run: uv publish
+      

uipath_llm_client-1.0.0/.github/workflows/cd.yml

@@ -0,0 +1,51 @@
+name: Publish uipath-llm-client to PyPI
+
+on:
+  push:
+    tags:
+      # Publish on any tag starting with a `v`, e.g., v1.0.0
+      - v*
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build package
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9.27"
+          enable-cache: true
+
+      - name: "Set up Python"
+        uses: actions/setup-python@v6
+        with:
+          python-version-file: ".python-version"
+      
+      - name: "Install dependencies"
+        run: uv sync --dev --all-extras --locked
+
+      - name: Build package
+        run: uv build --package uipath-llm-client
+
+      - name: Smoke test (wheel with all extras)
+        run: |
+          WHEEL=$(ls dist/*.whl)
+          uv run --isolated --no-project --with "${WHEEL}[all]" tests/core/core_smoke_test.py
+
+      - name: Smoke test (source distribution with all extras)
+        run: |
+          SDIST=$(ls dist/*.tar.gz)
+          uv run --isolated --no-project --with "${SDIST}[all]" tests/core/core_smoke_test.py
+
+      - name: Publish package
+        run: uv publish
+      

uipath_llm_client-1.0.0/.github/workflows/ci_change_version.yml

@@ -0,0 +1,88 @@
+name: Validate Version and Changelog
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  validate-version:
+    name: Validate version updates
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Get changed files
+        id: changes
+        run: |
+          git diff origin/main...HEAD --name-only > changes.txt
+          echo "Changed files:"
+          cat changes.txt
+
+      - name: Validate version updates for changed packages
+        run: |
+          VALIDATION_FAILED=0
+
+          # Core package: src/uipath_llm_client/ -> src/uipath_llm_client/__version__.py
+          core_changes=$(grep -E '^src/uipath_llm_client/' changes.txt | grep -v '__version__.py' || true)
+          core_version=$(grep -E '^src/uipath_llm_client/__version__.py' changes.txt || true)
+          if [ -n "$core_changes" ] && [ -z "$core_version" ]; then
+            echo "::error::Core package (src/uipath_llm_client/) changes detected but no version update in src/uipath_llm_client/__version__.py"
+            VALIDATION_FAILED=1
+          fi
+
+          # Langchain package: packages/uipath_langchain_client/ -> packages/uipath_langchain_client/src/uipath_langchain_client/__version__.py
+          langchain_changes=$(grep -E '^packages/uipath_langchain_client/' changes.txt | grep -v '__version__.py' || true)
+          langchain_version=$(grep -E '^packages/uipath_langchain_client/src/uipath_langchain_client/__version__.py' changes.txt || true)
+          if [ -n "$langchain_changes" ] && [ -z "$langchain_version" ]; then
+            echo "::error::Langchain package (packages/uipath_langchain_client/) changes detected but no version update in packages/uipath_langchain_client/src/uipath_langchain_client/__version__.py"
+            VALIDATION_FAILED=1
+          fi
+
+          # LlamaIndex package: packages/uipath_llamaindex_client/ -> packages/uipath_llamaindex_client/src/uipath_llamaindex_client/__version__.py
+          llamaindex_changes=$(grep -E '^packages/uipath_llamaindex_client/' changes.txt | grep -v '__version__.py' || true)
+          llamaindex_version=$(grep -E '^packages/uipath_llamaindex_client/src/uipath_llamaindex_client/__version__.py' changes.txt || true)
+          if [ -n "$llamaindex_changes" ] && [ -z "$llamaindex_version" ]; then
+            echo "::error::LlamaIndex package (packages/uipath_llamaindex_client/) changes detected but no version update in packages/uipath_llamaindex_client/src/uipath_llamaindex_client/__version__.py"
+            VALIDATION_FAILED=1
+          fi
+
+          if [ $VALIDATION_FAILED -eq 1 ]; then
+            exit 1
+          fi
+          echo "✓ All package versions are consistent with changes."
+
+      - name: Validate changelog updates for version changes
+        run: |
+          VALIDATION_FAILED=0
+
+          # Core package: src/uipath_llm_client/__version__.py -> CHANGELOG.md (root)
+          core_version=$(grep -E '^src/uipath_llm_client/__version__.py' changes.txt || true)
+          core_changelog=$(grep -E '^CHANGELOG.md' changes.txt || true)
+          if [ -n "$core_version" ] && [ -z "$core_changelog" ]; then
+            echo "::error::Core package version changed but no changelog update in CHANGELOG.md"
+            VALIDATION_FAILED=1
+          fi
+
+          # Langchain package: packages/uipath_langchain_client/src/uipath_langchain_client/__version__.py -> packages/uipath_langchain_client/CHANGELOG.md
+          langchain_version=$(grep -E '^packages/uipath_langchain_client/src/uipath_langchain_client/__version__.py' changes.txt || true)
+          langchain_changelog=$(grep -E '^packages/uipath_langchain_client/CHANGELOG.md' changes.txt || true)
+          if [ -n "$langchain_version" ] && [ -z "$langchain_changelog" ]; then
+            echo "::error::Langchain package version changed but no changelog update in packages/uipath_langchain_client/CHANGELOG.md"
+            VALIDATION_FAILED=1
+          fi
+
+          # LlamaIndex package: packages/uipath_llamaindex_client/src/uipath_llamaindex_client/__version__.py -> packages/uipath_llamaindex_client/CHANGELOG.md
+          llamaindex_version=$(grep -E '^packages/uipath_llamaindex_client/src/uipath_llamaindex_client/__version__.py' changes.txt || true)
+          llamaindex_changelog=$(grep -E '^packages/uipath_llamaindex_client/CHANGELOG.md' changes.txt || true)
+          if [ -n "$llamaindex_version" ] && [ -z "$llamaindex_changelog" ]; then
+            echo "::error::LlamaIndex package version changed but no changelog update in packages/uipath_llamaindex_client/CHANGELOG.md"
+            VALIDATION_FAILED=1
+          fi
+
+          if [ $VALIDATION_FAILED -eq 1 ]; then
+            exit 1
+          fi
+          echo "✓ All changelogs are consistent with version changes."

uipath_llm_client-1.0.0/.github/workflows/ci_run_tests.yml

@@ -0,0 +1,33 @@
+name: Run Tests
+
+on:
+  workflow_run:
+    workflows: ["Type Check & Lint"]
+    types:
+      - completed
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    # Only run if the type check workflow succeeded
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9.27"
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version-file: ".python-version"
+
+      - name: Install dependencies
+        run: uv sync --dev --all-extras
+
+      - name: Run tests
+        run: uv run pytest tests

uipath_llm_client-1.0.0/.github/workflows/ci_type_check.yml

@@ -0,0 +1,35 @@
+name: Type Check & Lint
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  lint-and-typecheck:
+    name: Lint & Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9.27"
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version-file: ".python-version"
+
+      - name: Install dependencies
+        run: uv sync --dev --all-extras
+
+      - name: Ruff check
+        run: |
+          uv run ruff check || exit 1
+          uv run ruff format --check || exit 1
+
+      - name: Pyright
+        run: uv run pyright .

uipath_llm_client-1.0.0/.github/workflows/publish-dev.yml

@@ -0,0 +1,213 @@
+name: Publish Dev Build
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, labeled]
+
+jobs:
+  detect-changes:
+    runs-on: ubuntu-latest
+    if: contains(github.event.pull_request.labels.*.name, 'build:dev')
+    outputs:
+      core-changed: ${{ steps.changes.outputs.core }}
+      langchain-changed: ${{ steps.changes.outputs.langchain }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Detect changed packages
+        id: changes
+        run: |
+          # Get list of changed files
+          git diff origin/main...HEAD --name-only > changes.txt
+          echo "Changed files:"
+          cat changes.txt
+
+          # Check if core package changed
+          if grep -qE '^src/uipath_llm_client/' changes.txt; then
+            echo "core=true" >> $GITHUB_OUTPUT
+            echo "Core package has changes"
+          else
+            echo "core=false" >> $GITHUB_OUTPUT
+            echo "Core package has no changes"
+          fi
+
+          # Check if langchain package changed
+          if grep -qE '^packages/uipath_langchain_client/' changes.txt; then
+            echo "langchain=true" >> $GITHUB_OUTPUT
+            echo "Langchain package has changes"
+          else
+            echo "langchain=false" >> $GITHUB_OUTPUT
+            echo "Langchain package has no changes"
+          fi
+
+  publish-dev:
+    needs: detect-changes
+    runs-on: ubuntu-latest
+    if: needs.detect-changes.outputs.core-changed == 'true' || needs.detect-changes.outputs.langchain-changed == 'true'
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9.27"
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version-file: ".python-version"
+
+      - name: Install dependencies
+        run: uv sync --dev --all-extras
+
+      - name: Set development versions and update PR
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          CORE_CHANGED: ${{ needs.detect-changes.outputs.core-changed }}
+          LANGCHAIN_CHANGED: ${{ needs.detect-changes.outputs.langchain-changed }}
+        run: |
+          # Get PR number and run number with proper padding
+          PR_NUM="${{ github.event.pull_request.number }}"
+          PADDED_PR=$(printf "%05d" $PR_NUM)
+          PADDED_RUN=$(printf "%04d" ${{ github.run_number }})
+          NEXT_PR=$((PR_NUM + 1))
+          PADDED_NEXT_PR=$(printf "%05d" $NEXT_PR)
+
+          # Initialize arrays for changed packages
+          PACKAGES_INFO=""
+          DEPENDENCIES_EXACT=""
+          DEPENDENCIES_RANGE=""
+          SOURCES=""
+          OVERRIDES=""
+
+          # Process core package if changed
+          if [ "$CORE_CHANGED" == "true" ]; then
+            # Read current version from __version__.py
+            CORE_VERSION=$(grep -oP '__version__\s*=\s*"\K[^"]+' src/uipath_llm_client/__version__.py)
+            DEV_VERSION="${CORE_VERSION}.dev1${PADDED_PR}${PADDED_RUN}"
+            MIN_VERSION="${CORE_VERSION}.dev1${PADDED_PR}0000"
+            MAX_VERSION="${CORE_VERSION}.dev1${PADDED_NEXT_PR}0000"
+
+            # Update __version__.py
+            sed -i "s/__version__ = \".*\"/__version__ = \"${DEV_VERSION}\"/" src/uipath_llm_client/__version__.py
+            echo "Core package version set to $DEV_VERSION"
+
+            DEPENDENCIES_EXACT="${DEPENDENCIES_EXACT}    \"uipath-llm-client==${DEV_VERSION}\",\n"
+            DEPENDENCIES_RANGE="${DEPENDENCIES_RANGE}    \"uipath-llm-client>=${MIN_VERSION},<${MAX_VERSION}\",\n"
+            SOURCES="${SOURCES}uipath-llm-client = { index = \"testpypi\" }\n"
+            OVERRIDES="${OVERRIDES}    \"uipath-llm-client>=${MIN_VERSION},<${MAX_VERSION}\",\n"
+          fi
+
+          # Process langchain package if changed
+          if [ "$LANGCHAIN_CHANGED" == "true" ]; then
+            # Read current version from __version__.py
+            LC_VERSION=$(grep -oP '__version__\s*=\s*"\K[^"]+' packages/uipath_langchain_client/src/uipath_langchain_client/__version__.py)
+            DEV_VERSION="${LC_VERSION}.dev1${PADDED_PR}${PADDED_RUN}"
+            MIN_VERSION="${LC_VERSION}.dev1${PADDED_PR}0000"
+            MAX_VERSION="${LC_VERSION}.dev1${PADDED_NEXT_PR}0000"
+
+            # Update __version__.py
+            sed -i "s/__version__ = \".*\"/__version__ = \"${DEV_VERSION}\"/" packages/uipath_langchain_client/src/uipath_langchain_client/__version__.py
+            echo "Langchain package version set to $DEV_VERSION"
+
+            DEPENDENCIES_EXACT="${DEPENDENCIES_EXACT}    \"uipath-langchain-client==${DEV_VERSION}\",\n"
+            DEPENDENCIES_RANGE="${DEPENDENCIES_RANGE}    \"uipath-langchain-client>=${MIN_VERSION},<${MAX_VERSION}\",\n"
+            SOURCES="${SOURCES}uipath-langchain-client = { index = \"testpypi\" }\n"
+            OVERRIDES="${OVERRIDES}    \"uipath-langchain-client>=${MIN_VERSION},<${MAX_VERSION}\",\n"
+          fi
+
+          # Build PR description
+          cat > /tmp/pr_update.md << 'HEREDOC_END'
+          <!-- DEV_PACKAGE_START -->
+          ## Development Package
+
+          Add these packages as dependencies in your pyproject.toml:
+
+          ```toml
+          [project]
+          dependencies = [
+            # Exact versions:
+          HEREDOC_END
+
+          echo -e "${DEPENDENCIES_EXACT}" >> /tmp/pr_update.md
+
+          cat >> /tmp/pr_update.md << 'HEREDOC_END'
+            # Or use version ranges for any build from this PR:
+          HEREDOC_END
+
+          echo -e "${DEPENDENCIES_RANGE}" >> /tmp/pr_update.md
+
+          cat >> /tmp/pr_update.md << 'HEREDOC_END'
+          ]
+
+          [[tool.uv.index]]
+          name = "testpypi"
+          url = "https://test.pypi.org/simple/"
+          publish-url = "https://test.pypi.org/legacy/"
+          explicit = true
+
+          [tool.uv.sources]
+          HEREDOC_END
+
+          echo -e "${SOURCES}" >> /tmp/pr_update.md
+
+          cat >> /tmp/pr_update.md << 'HEREDOC_END'
+
+          [tool.uv]
+          override-dependencies = [
+          HEREDOC_END
+
+          echo -e "${OVERRIDES}" >> /tmp/pr_update.md
+
+          cat >> /tmp/pr_update.md << 'HEREDOC_END'
+          ]
+          ```
+          <!-- DEV_PACKAGE_END -->
+          HEREDOC_END
+
+          DEV_MESSAGE=$(cat /tmp/pr_update.md)
+
+          # Update PR description using GitHub API
+          PR_URL="https://api.github.com/repos/${{ github.repository }}/pulls/${PR_NUM}"
+          CURRENT_BODY=$(gh pr view ${PR_NUM} --json body -q '.body' || echo "")
+
+          # Check if markers exist and replace or append
+          if echo "$CURRENT_BODY" | grep -q "<!-- DEV_PACKAGE_START -->"; then
+            # Replace content between markers
+            NEW_BODY=$(echo "$CURRENT_BODY" | sed '/<!-- DEV_PACKAGE_START -->/,/<!-- DEV_PACKAGE_END -->/d')
+            NEW_BODY="${NEW_BODY}
+
+          ${DEV_MESSAGE}"
+          else
+            # Append to end
+            NEW_BODY="${CURRENT_BODY}
+
+          ${DEV_MESSAGE}"
+          fi
+
+          # Update PR
+          gh pr edit ${PR_NUM} --body "$NEW_BODY"
+          echo "Updated PR description with development package information"
+
+      - name: Build core package
+        if: needs.detect-changes.outputs.core-changed == 'true'
+        run: uv build --package uipath-llm-client
+
+      - name: Build langchain package
+        if: needs.detect-changes.outputs.langchain-changed == 'true'
+        run: uv build --package uipath-langchain-client
+
+      - name: Publish core package
+        if: needs.detect-changes.outputs.core-changed == 'true'
+        run: uv publish dist/uipath_llm_client* --index testpypi --token ${{ secrets.UV_PUBLISH_TOKEN_UIPATH_LLM_CLIENT }}
+
+      - name: Publish langchain package
+        if: needs.detect-changes.outputs.langchain-changed == 'true'
+        run: uv publish dist/uipath_langchain_client* --index testpypi --token ${{ secrets.UV_PUBLISH_TOKEN_UIPATH_LANGCHAIN_CLIENT }}