openviking 0.2.15__tar.gz → 0.2.16.dev9__tar.gz

openviking-0.2.16.dev9/.github/workflows/api_test.yml

@@ -0,0 +1,477 @@
+name: 03. API Integration Tests
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - 'api_test'
+      - 'main'
+    paths-ignore:
+      - 'docs/**'
+      - '**.md'
+      - 'LICENSE'
+      - 'CONTRIBUTING.md'
+      - '**.png'
+      - '**.jpg'
+      - '**.jpeg'
+      - '**.gif'
+      - '**.svg'
+      - '.gitignore'
+      - '.editorconfig'
+  pull_request:
+    branches:
+      - 'main'
+    paths-ignore:
+      - 'docs/**'
+      - '**.md'
+      - 'LICENSE'
+      - 'CONTRIBUTING.md'
+      - '**.png'
+      - '**.jpg'
+      - '**.jpeg'
+      - '**.gif'
+      - '**.svg'
+      - '.gitignore'
+      - '.editorconfig'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  api-tests:
+    name: API Integration Tests (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04, ubuntu-24.04-arm, macos-14, macos-15-intel, windows-latest]
+    
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          submodules: recursive
+
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.10'
+
+      - name: Cache Go modules
+        uses: actions/cache@v4
+        with:
+          path: ~/go/pkg/mod
+          key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
+          restore-keys: |
+            ${{ runner.os }}-go-
+
+      - name: Cache C++ extensions
+        uses: actions/cache@v4
+        with:
+          path: openviking/pyagfs
+          key: ${{ runner.os }}-cpp-${{ hashFiles('**/CMakeLists.txt', '**/*.cpp', '**/*.h') }}
+          restore-keys: |
+            ${{ runner.os }}-cpp-
+
+      - name: Cache Python dependencies (Unix)
+        if: runner.os != 'Windows'
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt', '**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Cache Python dependencies (Windows)
+        if: runner.os == 'Windows'
+        uses: actions/cache@v4
+        with:
+          path: ~\AppData\Local\pip\Cache
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt', '**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Set up Go
+        uses: actions/setup-go@v6
+        with:
+          go-version: '1.22'
+
+      - name: Install system dependencies (Ubuntu)
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update -y && sudo apt-get install -y cmake build-essential --no-install-recommends
+
+      - name: Install system dependencies (macOS)
+        if: runner.os == 'macOS'
+        run: |
+          brew install cmake
+
+      - name: Install system dependencies (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          choco install cmake -y
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Install build dependencies (system pip)
+        run: |
+          python -m pip install --upgrade pip
+          pip install "setuptools>=70.1" setuptools_scm cmake wheel
+          echo "---"
+          python -c "import setuptools; print(f'setuptools version: {setuptools.__version__}')"
+
+      - name: Install dependencies using uv sync
+        run: |
+          echo "Installing dependencies using uv sync..."
+          uv sync --frozen
+
+      - name: Install build dependencies (uv pip)
+        run: |
+          echo "Installing build dependencies to uv environment..."
+          uv pip install setuptools setuptools_scm cmake wheel
+
+      - name: Build C++ extensions
+        run: |
+          uv run python setup.py build_ext --inplace
+
+      - name: Install API test dependencies
+        run: |
+          cd tests/api_test
+          uv pip install -r requirements.txt
+
+      - name: Create OpenViking config file (Unix)
+        if: runner.os != 'Windows'
+        id: create-config-unix
+        env:
+          VLM_API_KEY: ${{ secrets.VLM_API_KEY }}
+          EMBEDDING_API_KEY: ${{ secrets.EMBEDDING_API_KEY }}
+        run: |
+          mkdir -p $HOME/.openviking
+          
+          HAS_SECRETS=false
+          if [ -n "$VLM_API_KEY" ] && [ -n "$EMBEDDING_API_KEY" ]; then
+            HAS_SECRETS=true
+            echo "Using full configuration with VLM and Embedding"
+          else
+            echo "Using minimal configuration (no VLM/Embedding)"
+          fi
+          
+          echo "HAS_SECRETS=$HAS_SECRETS" >> $GITHUB_ENV
+          
+          if [ "$HAS_SECRETS" = "true" ]; then
+            cat > $HOME/.openviking/ov.conf << EOF
+          {
+            "server": {
+              "root_api_key": "test-root-api-key"
+            },
+            "vlm": {
+              "provider": "volcengine",
+              "api_key": "$VLM_API_KEY",
+              "model": "doubao-seed-2-0-mini-260215",
+              "api_base": "https://ark.cn-beijing.volces.com/api/v3",
+              "temperature": 0.1,
+              "max_retries": 3
+            },
+            "embedding": {
+              "dense": {
+                "provider": "volcengine",
+                "api_key": "$EMBEDDING_API_KEY",
+                "model": "doubao-embedding-vision-251215",
+                "api_base": "https://ark.cn-beijing.volces.com/api/v3",
+                "dimension": 1024,
+                "input": "multimodal"
+              }
+            }
+          }
+          EOF
+          else
+            cat > $HOME/.openviking/ov.conf << EOF
+          {
+            "server": {
+              "root_api_key": "test-root-api-key"
+            },
+            "vlm": {
+              "provider": "volcengine",
+              "api_key": "dummy-vlm-api-key",
+              "model": "doubao-seed-2-0-mini-260215",
+              "api_base": "https://ark.cn-beijing.volces.com/api/v3",
+              "temperature": 0.1,
+              "max_retries": 3
+            },
+            "embedding": {
+              "dense": {
+                "provider": "volcengine",
+                "api_key": "dummy-embedding-api-key",
+                "model": "doubao-embedding-vision-251215",
+                "api_base": "https://ark.cn-beijing.volces.com/api/v3",
+                "dimension": 1024,
+                "input": "multimodal"
+              }
+            }
+          }
+          EOF
+          fi
+          
+          echo "Config file created at $HOME/.openviking/ov.conf"
+
+      - name: Create OpenViking config file (Windows)
+        if: runner.os == 'Windows'
+        id: create-config-windows
+        env:
+          VLM_API_KEY: ${{ secrets.VLM_API_KEY }}
+          EMBEDDING_API_KEY: ${{ secrets.EMBEDDING_API_KEY }}
+        shell: pwsh
+        run: |
+          $configDir = "$env:USERPROFILE\.openviking"
+          New-Item -ItemType Directory -Force -Path $configDir | Out-Null
+          
+          $hasSecrets = "false"
+          if ($env:VLM_API_KEY -and $env:EMBEDDING_API_KEY) {
+            $hasSecrets = "true"
+            Write-Host "Using full configuration with VLM and Embedding"
+          } else {
+            Write-Host "Using minimal configuration (no VLM/Embedding)"
+          }
+          
+          echo "HAS_SECRETS=$hasSecrets" >> $env:GITHUB_ENV
+          
+          if ($hasSecrets -eq "true") {
+            $config = @"
+          {
+            "server": {
+              "root_api_key": "test-root-api-key"
+            },
+            "vlm": {
+              "provider": "volcengine",
+              "api_key": "$env:VLM_API_KEY",
+              "model": "doubao-seed-2-0-mini-260215",
+              "api_base": "https://ark.cn-beijing.volces.com/api/v3",
+              "temperature": 0.1,
+              "max_retries": 3
+            },
+            "embedding": {
+              "dense": {
+                "provider": "volcengine",
+                "api_key": "$env:EMBEDDING_API_KEY",
+                "model": "doubao-embedding-vision-251215",
+                "api_base": "https://ark.cn-beijing.volces.com/api/v3",
+                "dimension": 1024,
+                "input": "multimodal"
+              }
+            }
+          }
+          "@
+          } else {
+            $config = @"
+          {
+            "server": {
+              "root_api_key": "test-root-api-key"
+            },
+            "vlm": {
+              "provider": "volcengine",
+              "api_key": "dummy-vlm-api-key",
+              "model": "doubao-seed-2-0-mini-260215",
+              "api_base": "https://ark.cn-beijing.volces.com/api/v3",
+              "temperature": 0.1,
+              "max_retries": 3
+            },
+            "embedding": {
+              "dense": {
+                "provider": "volcengine",
+                "api_key": "dummy-embedding-api-key",
+                "model": "doubao-embedding-vision-251215",
+                "api_base": "https://ark.cn-beijing.volces.com/api/v3",
+                "dimension": 1024,
+                "input": "multimodal"
+              }
+            }
+          }
+          "@
+          }
+          
+          $config | Out-File -FilePath "$configDir\ov.conf" -Encoding utf8
+          Write-Host "Config file created at $configDir\ov.conf"
+
+      - name: Find available port and start OpenViking Server (Unix)
+        if: runner.os != 'Windows'
+        id: start-server-unix
+        run: |
+          find_available_port() {
+            local port=1933
+            while true; do
+              if ! lsof -Pi :$port -sTCP:LISTEN -t >/dev/null 2>&1; then
+                echo $port
+                return
+              fi
+              port=$((port + 1))
+            done
+          }
+          
+          SERVER_PORT=$(find_available_port)
+          echo "Using port: $SERVER_PORT"
+          echo "SERVER_PORT=$SERVER_PORT" >> $GITHUB_ENV
+          
+          echo "Starting OpenViking Server on port $SERVER_PORT..."
+          export ROOT_API_KEY=test-root-api-key
+          export SERVER_PORT=$SERVER_PORT
+          nohup uv run python -m openviking.server.bootstrap > openviking-server.log 2>&1 &
+          echo $! > openviking-server.pid
+          echo "SERVER_PID=$(cat openviking-server.pid)" >> $GITHUB_ENV
+          
+          echo "Waiting for server to start..."
+          for i in {1..30}; do
+            if curl -s http://127.0.0.1:$SERVER_PORT/health | grep -q '"healthy":true'; then
+              echo "Server is ready!"
+              break
+            fi
+            echo "Waiting... ($i/30)"
+            sleep 2
+          done
+          
+          if ! curl -s http://127.0.0.1:$SERVER_PORT/health | grep -q '"healthy":true'; then
+            echo "Server failed to start!"
+            echo "Server logs:"
+            cat openviking-server.log
+            exit 1
+          fi
+
+      - name: Find available port and start OpenViking Server (Windows)
+        if: runner.os == 'Windows'
+        id: start-server-windows
+        shell: pwsh
+        run: |
+          $port = 1933
+          Write-Host "Using port: $port"
+          echo "SERVER_PORT=$port" >> $env:GITHUB_ENV
+          
+          Write-Host "Starting OpenViking Server on port $port..."
+          
+          $logFile = Join-Path $PWD "openviking-server.log"
+          $errFile = Join-Path $PWD "openviking-server-error.log"
+          $batchFile = Join-Path $PWD "start-server.bat"
+          
+          $batchContent = "@echo off`r`nset ROOT_API_KEY=test-root-api-key`r`nset SERVER_PORT=$port`r`nuv run python -m openviking.server.bootstrap`r`n"
+          Set-Content -Path $batchFile -Value $batchContent -Encoding ASCII
+          
+          Write-Host "Batch file created at: $batchFile"
+          Write-Host "Batch file content:"
+          Get-Content $batchFile
+          
+          $psi = New-Object System.Diagnostics.ProcessStartInfo
+          $psi.FileName = "cmd.exe"
+          $psi.Arguments = "/C `"$batchFile`""
+          $psi.UseShellExecute = $true
+          $psi.WindowStyle = [System.Diagnostics.ProcessWindowStyle]::Hidden
+          $psi.WorkingDirectory = $PWD.Path
+          
+          $process = [System.Diagnostics.Process]::Start($psi)
+          
+          Write-Host "Server process started with PID: $($process.Id)"
+          echo "SERVER_PID=$($process.Id)" >> $env:GITHUB_ENV
+          
+          Write-Host "Waiting for server to start..."
+          $ready = $false
+          for ($i = 1; $i -le 30; $i++) {
+            Start-Sleep -Seconds 2
+            try {
+              $response = Invoke-WebRequest -Uri "http://127.0.0.1:$port/health" -UseBasicParsing -TimeoutSec 5
+              if ($response.Content -match '"healthy":true') {
+                Write-Host "Server is ready!"
+                $ready = $true
+                break
+              }
+            } catch {
+              Write-Host "Waiting... ($i/30)"
+            }
+          }
+          
+          if (-not $ready) {
+            Write-Host "Server failed to start!"
+            Write-Host "Checking if process is still running..."
+            $proc = Get-Process -Id $process.Id -ErrorAction SilentlyContinue
+            if ($proc) {
+              Write-Host "Process is still running with PID: $($proc.Id)"
+            } else {
+              Write-Host "Process has exited"
+            }
+            exit 1
+          }
+
+      - name: Run API Tests (Unix)
+        if: runner.os != 'Windows'
+        id: run-tests-unix
+        run: |
+          cd tests/api_test
+          export OPENVIKING_API_KEY=test-root-api-key
+          export SERVER_URL=http://127.0.0.1:${{ env.SERVER_PORT }}
+          
+          if [ "${{ env.HAS_SECRETS }}" = "true" ]; then
+            echo "Running full test suite with VLM/Embedding"
+            uv run python -m pytest . -v --html=api-test-report.html --self-contained-html
+          else
+            echo "Running basic tests only (no VLM/Embedding)"
+            uv run python -m pytest . -v --html=api-test-report.html --self-contained-html \
+              --ignore=retrieval/ --ignore=resources/test_pack.py --ignore=resources/test_wait_processed.py \
+              --ignore=admin/ --ignore=skills/ --ignore=system/test_system_status.py --ignore=system/test_is_healthy.py --ignore=system/test_system_wait.py -k "not test_observer"
+          fi
+        continue-on-error: true
+
+      - name: Run API Tests (Windows)
+        if: runner.os == 'Windows'
+        id: run-tests-windows
+        shell: pwsh
+        run: |
+          cd tests/api_test
+          $env:OPENVIKING_API_KEY = "test-root-api-key"
+          $env:SERVER_URL = "http://127.0.0.1:${{ env.SERVER_PORT }}"
+          
+          if ($env:HAS_SECRETS -eq "true") {
+            Write-Host "Running full test suite with VLM/Embedding"
+            uv run python -m pytest . -v --html=api-test-report.html --self-contained-html
+          } else {
+            Write-Host "Running basic tests only (no VLM/Embedding)"
+            uv run python -m pytest . -v --html=api-test-report.html --self-contained-html --ignore=retrieval/ --ignore=resources/test_pack.py --ignore=resources/test_wait_processed.py --ignore=admin/ --ignore=skills/ --ignore=system/test_system_status.py --ignore=system/test_is_healthy.py --ignore=system/test_system_wait.py -k "not test_observer"
+          }
+        continue-on-error: true
+
+      - name: Upload test reports
+        uses: actions/upload-artifact@v7
+        if: always()
+        with:
+          name: api-test-reports-${{ matrix.os }}-${{ github.run_id }}
+          path: |
+            tests/api_test/api-test-report.html
+            openviking-server.log
+
+      - name: Stop OpenViking Server (Unix)
+        if: runner.os != 'Windows' && always()
+        run: |
+          if [ -f openviking-server.pid ]; then
+            kill $(cat openviking-server.pid) 2>/dev/null || true
+            pkill -f "openviking.server.bootstrap" 2>/dev/null || true
+          fi
+
+      - name: Stop OpenViking Server (Windows)
+        if: runner.os == 'Windows' && always()
+        shell: pwsh
+        run: |
+          if ($env:SERVER_PID) {
+            Stop-Process -Id $env:SERVER_PID -Force -ErrorAction SilentlyContinue
+          }
+          Get-Process -Name python -ErrorAction SilentlyContinue | Stop-Process -Force
+
+      - name: Check test results (Unix)
+        if: runner.os != 'Windows' && steps.run-tests-unix.outcome != 'success'
+        run: |
+          echo "API tests failed!"
+          exit 1
+
+      - name: Check test results (Windows)
+        if: runner.os == 'Windows' && steps.run-tests-windows.outcome != 'success'
+        shell: pwsh
+        run: |
+          Write-Host "API tests failed!"
+          exit 1

openviking-0.2.16.dev9/.github/workflows/build-docker-image.yml

@@ -0,0 +1,159 @@
+name: Build and Push Docker Image
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "application version for OpenViking"
+        required: true
+        type: string
+  push:
+    tags: [ "v*.*.*" ]
+
+env:
+  REGISTRY: ghcr.io
+
+jobs:
+  build-and-push-image:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - arch: amd64
+            platform: linux/amd64
+            runner: ubuntu-24.04
+          - arch: arm64
+            platform: linux/arm64
+            runner: ubuntu-24.04-arm
+    runs-on: ${{ matrix.runner }}
+    permissions:
+      contents: read
+      packages: write
+      attestations: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          submodules: recursive
+
+      - name: Normalize image name
+        id: image-name
+        env:
+          RAW_IMAGE_NAME: ${{ github.repository }}
+        run: |
+          echo "image=$(echo "$RAW_IMAGE_NAME" | tr '[:upper:]' '[:lower:]')" >> "$GITHUB_OUTPUT"
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@v4
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v6
+        with:
+          images: ${{ env.REGISTRY }}/${{ steps.image-name.outputs.image }}
+          tags: |
+            type=raw,value=${{ github.event.inputs.version }},enable=${{ github.event_name == 'workflow_dispatch' }}
+            type=ref,event=tag,enable=${{ github.ref_type == 'tag' }}
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
+
+      - name: Build and push Docker image
+        id: push
+        uses: docker/build-push-action@v7
+        with:
+          context: .
+          platforms: ${{ matrix.platform }}
+          outputs: type=image,name=${{ env.REGISTRY }}/${{ steps.image-name.outputs.image }},push-by-digest=true,name-canonical=true,push=true
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            # fallback to 0.0.0 if no version is provided
+            OPENVIKING_VERSION=${{ (github.event_name == 'workflow_dispatch' && github.event.inputs.version) || (github.ref_type == 'tag' && github.ref_name) || '0.0.0' }}
+
+      - name: Export image digest
+        run: |
+          mkdir -p /tmp/digests
+          digest="${{ steps.push.outputs.digest }}"
+          touch "/tmp/digests/${digest#sha256:}"
+
+      - name: Upload image digest
+        uses: actions/upload-artifact@v7
+        with:
+          name: docker-digests-${{ matrix.arch }}
+          path: /tmp/digests/*
+          if-no-files-found: error
+          retention-days: 1
+
+  create-manifest:
+    runs-on: ubuntu-24.04
+    needs: build-and-push-image
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          submodules: recursive
+
+      - name: Normalize image name
+        id: image-name
+        env:
+          RAW_IMAGE_NAME: ${{ github.repository }}
+        run: |
+          echo "image=$(echo "$RAW_IMAGE_NAME" | tr '[:upper:]' '[:lower:]')" >> "$GITHUB_OUTPUT"
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@v4
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v6
+        with:
+          images: ${{ env.REGISTRY }}/${{ steps.image-name.outputs.image }}
+          tags: |
+            type=raw,value=${{ github.event.inputs.version }},enable=${{ github.event_name == 'workflow_dispatch' }}
+            type=ref,event=tag,enable=${{ github.ref_type == 'tag' }}
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
+
+      - name: Download image digests
+        uses: actions/download-artifact@v8
+        with:
+          pattern: docker-digests-*
+          path: /tmp/digests
+          merge-multiple: true
+
+      - name: Create multi-arch manifests
+        env:
+          SOURCE_TAGS: ${{ steps.meta.outputs.tags }}
+        run: |
+          image_refs=()
+          for digest_file in /tmp/digests/*; do
+            [ -e "$digest_file" ] || continue
+            image_refs+=("${{ env.REGISTRY }}/${{ steps.image-name.outputs.image }}@sha256:$(basename "$digest_file")")
+          done
+
+          [ ${#image_refs[@]} -gt 0 ] || {
+            echo "No image digests found" >&2
+            exit 1
+          }
+
+          while IFS= read -r tag; do
+            [ -n "$tag" ] || continue
+            docker buildx imagetools create \
+              --tag "$tag" \
+              "${image_refs[@]}"
+          done <<< "$SOURCE_TAGS"