Merge remote-tracking branch 'upstream/main' into streaming-responses

Author: enyst

.github/prompts/update-documentation.md

@@ -14,8 +14,8 @@ You are a world-class documentation writer tasked with keeping the OpenHands Age
 ### 1. Codebase Analysis
 
 - Scan `examples/` for available examples
-- Scan `openhands/tools/` for all available runtime tools
-- Check `openhands/sdk/tool/builtins/` for built-in tools
+- Scan `openhands-tools/` for all available runtime tools
+- Check `openhands-sdk/openhands/tool/builtins/` for built-in tools
 - Identify any new tools or removed tools since last update
 
 ### 2. Documentation Review

.github/workflows/assign-reviews.yml

@@ -22,11 +22,10 @@ permissions:
 
 jobs:
     run-task:
-        runs-on: ubuntu-latest
+        runs-on: blacksmith-4vcpu-ubuntu-2404
         env:
             # Configuration (modify these values as needed)
-            AGENT_SCRIPT_URL: 
-                https://raw.githubusercontent.com/All-Hands-AI/agent-sdk/main/examples/03_github_workflows/01_basic_action/agent_script.py
+            AGENT_SCRIPT_URL: https://raw.githubusercontent.com/OpenHands/agent-sdk/main/examples/03_github_workflows/01_basic_action/agent_script.py
             # Provide either PROMPT_LOCATION (URL/file) OR PROMPT_STRING (direct text), not both
             # Option 1: Use a URL or file path for the prompt
             PROMPT_LOCATION: ''
@@ -79,23 +78,23 @@ jobs:
             LLM_BASE_URL: https://llm-proxy.eval.all-hands.dev
         steps:
             - name: Checkout repository
-              uses: actions/checkout@v4
+              uses: actions/checkout@v5
 
             - name: Set up Python
-              uses: actions/setup-python@v5
+              uses: actions/setup-python@v6
               with:
                   python-version: '3.12'
 
             - name: Install uv
-              uses: astral-sh/setup-uv@v6
+              uses: astral-sh/setup-uv@v7
               with:
                   enable-cache: true
 
             - name: Install OpenHands dependencies
               run: |
                   # Install OpenHands SDK and tools from git repository
-                  uv pip install --system "openhands-sdk @ git+https://github.com/All-Hands-AI/agent-sdk.git@main#subdirectory=openhands/sdk"
-                  uv pip install --system "openhands-tools @ git+https://github.com/All-Hands-AI/agent-sdk.git@main#subdirectory=openhands/tools"
+                  uv pip install --system "openhands-sdk @ git+https://github.com/OpenHands/agent-sdk.git@main#subdirectory=openhands-sdk"
+                  uv pip install --system "openhands-tools @ git+https://github.com/OpenHands/agent-sdk.git@main#subdirectory=openhands-tools"
 
             - name: Check required configuration
               env:

.github/workflows/deploy-docs.yml

@@ -3,22 +3,21 @@ name: Dispatch to docs repo
 
 on:
     push:
-        branches: [main]
+        branches:
+            - main
         paths:
-            - docs/**
+            - openhands-agent-server/**
     workflow_dispatch:
-
 jobs:
     dispatch:
-        runs-on: blacksmith-2vcpu-ubuntu-2404
-        strategy:
-            matrix:
-                repo: [All-Hands-AI/docs]
+        runs-on: blacksmith-4vcpu-ubuntu-2404
+        permissions:
+            contents: write
         steps:
-            - name: Push to docs repo
+            - name: Trigger docs repo sync
               uses: peter-evans/repository-dispatch@v4
               with:
                   token: ${{ secrets.ALLHANDS_BOT_GITHUB_PAT }}
-                  repository: ${{ matrix.repo }}
+                  repository: OpenHands/docs
                   event-type: update
-                  client-payload: '{"ref": "${{ github.ref }}", "sha": "${{ github.sha }}", "module": "agent-sdk", "branch": "main"}'
+                  client-payload: '{"ref": "${{ github.ref }}", "sha": "${{ github.sha }}"}'

.github/workflows/oh-update-documentation.yml.back

@@ -8,7 +8,7 @@ on:
 
 jobs:
   update-docs:
-    runs-on: ubuntu-latest
+    runs-on: blacksmith-4vcpu-ubuntu-2404
     permissions:
       contents: write
       pull-requests: write

.github/workflows/pr-review-by-openhands.yml

@@ -14,9 +14,8 @@ permissions:
 jobs:
     pr-review:
         if: github.event.label.name == 'review-this'
-        runs-on: ubuntu-latest
+        runs-on: blacksmith-4vcpu-ubuntu-2404
         env:
-            # Configuration (modify these values as needed)
             LLM_MODEL: litellm_proxy/claude-sonnet-4-5-20250929
             LLM_BASE_URL: https://llm-proxy.eval.all-hands.dev
             # PR context will be automatically provided by the agent script
@@ -28,13 +27,13 @@ jobs:
             REPO_NAME: ${{ github.repository }}
         steps:
             - name: Checkout agent-sdk repository
-              uses: actions/checkout@v4
+              uses: actions/checkout@v5
               with:
-                  repository: All-Hands-AI/agent-sdk
+                  repository: OpenHands/agent-sdk
                   path: agent-sdk
 
             - name: Checkout PR repository
-              uses: actions/checkout@v4
+              uses: actions/checkout@v5
               with:
                   # Fetch the full history to get the diff
                   fetch-depth: 0
@@ -43,12 +42,12 @@ jobs:
                   ref: ${{ github.event.pull_request.head.ref }}
 
             - name: Set up Python
-              uses: actions/setup-python@v5
+              uses: actions/setup-python@v6
               with:
                   python-version: '3.12'
 
             - name: Install uv
-              uses: astral-sh/setup-uv@v6
+              uses: astral-sh/setup-uv@v7
               with:
                   enable-cache: true
 
@@ -61,8 +60,8 @@ jobs:
             - name: Install OpenHands dependencies
               run: |
                   # Install OpenHands SDK and tools from git repository
-                  uv pip install --system "openhands-sdk @ git+https://github.com/All-Hands-AI/agent-sdk.git@main#subdirectory=openhands/sdk"
-                  uv pip install --system "openhands-tools @ git+https://github.com/All-Hands-AI/agent-sdk.git@main#subdirectory=openhands/tools"
+                  uv pip install --system "openhands-sdk @ git+https://github.com/OpenHands/agent-sdk.git@main#subdirectory=openhands-sdk"
+                  uv pip install --system "openhands-tools @ git+https://github.com/OpenHands/agent-sdk.git@main#subdirectory=openhands-tools"
 
             - name: Check required configuration
               env:

.github/workflows/pypi-release.yml

@@ -7,7 +7,7 @@ on:
 
 jobs:
     publish:
-        runs-on: ubuntu-latest
+        runs-on: blacksmith-4vcpu-ubuntu-2404
         steps:
             - name: Checkout
               uses: actions/checkout@v5

.github/workflows/server.yml

@@ -17,7 +17,7 @@ on:
             image:
                 description: GHCR image name
                 type: string
-                default: ghcr.io/all-hands-ai/agent-server
+                default: ghcr.io/openhands/agent-server
             platforms:
                 description: Target platforms
                 type: string
@@ -121,7 +121,6 @@ jobs:
             - name: Checkout PR branch
               uses: actions/checkout@v5
               with:
-                  ref: ${{ github.head_ref }}
                   fetch-depth: 0
 
             - name: Install uv
@@ -130,7 +129,7 @@ jobs:
                   version: latest
 
             - name: Install Node.js (for npx)
-              uses: actions/setup-node@v5
+              uses: actions/setup-node@v6
               with:
                   node-version: 22
 
@@ -147,10 +146,12 @@ jobs:
 
     build-and-push-image:
         name: Build & Push
-        # Run on all commits (push events and pull requests)
+        # Run on push events and pull requests from the same repository (not forks)
+        # Fork PRs cannot push to GHCR and would fail authentication
         if: >
             github.event_name == 'push' ||
-            github.event_name == 'pull_request'
+            (github.event_name == 'pull_request' &&
+             !github.event.pull_request.head.repo.fork)
         strategy:
             fail-fast: false
             matrix:
@@ -176,7 +177,7 @@ jobs:
         runs-on: ${{ matrix.runner }}
 
         env:
-            IMAGE: ${{ inputs.image != '' && inputs.image || 'ghcr.io/all-hands-ai/agent-server' }}
+            IMAGE: ${{ inputs.image != '' && inputs.image || 'ghcr.io/openhands/agent-server' }}
             BASE_IMAGE: ${{ inputs.base_image != '' && inputs.base_image || matrix.base_image }}
             CUSTOM_TAGS: ${{ matrix.name }}
             TARGET: binary
@@ -208,7 +209,7 @@ jobs:
               id: build
               run: |
                   uv sync --frozen
-                  uv run ./openhands/agent_server/docker/build.py
+                  uv run ./openhands-agent-server/openhands/agent_server/docker/build.py
 
             - name: Summary (${{ matrix.name }}) - outputs
               run: |
@@ -244,7 +245,7 @@ jobs:
         # Run if it's a PR and the matrix job completed (even if some variants failed)
         if: github.event_name == 'pull_request' && always() && (needs.build-and-push-image.result == 'success' || needs.build-and-push-image.result ==
             'failure')
-        runs-on: ubuntu-latest
+        runs-on: blacksmith-4vcpu-ubuntu-2404
         outputs:
             build_summary: ${{ steps.consolidate.outputs.build_summary }}
         steps:
@@ -316,7 +317,7 @@ jobs:
                   BUILD_SUMMARY=$(jq -n \
                       --arg image "$IMAGE" \
                       --arg short_sha "$SHORT_SHA" \
-                      --arg ghcr_url "https://github.com/All-Hands-AI/agent-sdk/pkgs/container/agent-server" \
+                      --arg ghcr_url "https://github.com/OpenHands/agent-sdk/pkgs/container/agent-server" \
                       --arg all_tags "$ALL_TAGS" \
                       --argjson variants "$VARIANTS_JSON" \
                       '{

.github/workflows/tests.yml

@@ -24,7 +24,7 @@ jobs:
               uses: tj-actions/changed-files@v47
               with:
                   files: |
-                      openhands/sdk/**
+                      openhands-sdk/**
                       tests/sdk/**
                       pyproject.toml
                       uv.lock
@@ -59,7 +59,7 @@ jobs:
                   rm -f .coverage
                   CI=true uv run python -m pytest -vvs \
                     --forked \
-                    --cov=openhands/sdk \
+                    --cov=openhands-sdk \
                     --cov-report=term-missing \
                     --cov-fail-under=0 \
                     --cov-config=pyproject.toml \
@@ -90,7 +90,7 @@ jobs:
               uses: tj-actions/changed-files@v47
               with:
                   files: |
-                      openhands/tools/**
+                      openhands-tools/**
                       tests/tools/**
                       pyproject.toml
                       uv.lock
@@ -113,7 +113,7 @@ jobs:
                   rm -f .coverage
                   CI=true uv run python -m pytest -vvs \
                     --forked \
-                    --cov=openhands/tools \
+                    --cov=openhands-tools \
                     --cov-report=term-missing \
                     --cov-fail-under=0 \
                     --cov-config=pyproject.toml \
@@ -144,7 +144,7 @@ jobs:
               uses: tj-actions/changed-files@v47
               with:
                   files: |
-                      openhands/agent_server/**
+                      openhands-agent-server/**
                       tests/agent_server/**
                       pyproject.toml
                       uv.lock
@@ -167,7 +167,7 @@ jobs:
                   rm -f .coverage
                   CI=true uv run python -m pytest -vvs \
                     --forked \
-                    --cov=openhands/agent_server \
+                    --cov=openhands-agent-server \
                     --cov-report=term-missing \
                     --cov-fail-under=0 \
                     --cov-config=pyproject.toml \