Fix issue #4629: '[Bug]: Replace claude-3-5-sonnet-20240620 with claude-3-5-sonnet-20241022'

"b/frontend/__tests__/utils/extractModelAndProvider.test.ts\""

@@ -0,0 +1,5 @@
+expect(extractModelAndProvider("claude-3-5-sonnet-20241022")).toEqual({
+      provider: "anthropic",
+      model: "claude-3-5-sonnet-20241022",
+      separator: "/",
+    });

"b/frontend/__tests__/utils/organizeModelsAndProviders.test.ts\""

@@ -0,0 +1,65 @@
+import { expect, test } from "vitest";
+import { organizeModelsAndProviders } from "../../src/utils/organizeModelsAndProviders";
+
+test("organizeModelsAndProviders", () => {
+  const models = [
+    "azure/ada",
+    "azure/gpt-35-turbo",
+    "azure/gpt-3-turbo",
+    "azure/standard/1024-x-1024/dall-e-2",
+    "vertex_ai_beta/chat-bison",
+    "vertex_ai_beta/chat-bison-32k",
+    "sagemaker/meta-textgeneration-llama-2-13b",
+    "cohere.command-r-v1:0",
+    "cloudflare/@cf/mistral/mistral-7b-instruct-v0.1",
+    "gpt-4o",
+    "together-ai-21.1b-41b",
+    "gpt-4o-mini",
+    "claude-3-5-sonnet-20241022",
+    "claude-3-haiku-20240307",
+    "claude-2",
+    "claude-2.1",
+    "anthropic.unsafe-claude-2.1",
+  ];
+
+  const object = organizeModelsAndProviders(models);
+
+  expect(object).toEqual({
+    azure: {
+      separator: "/",
+      models: [
+        "ada",
+        "gpt-35-turbo",
+        "gpt-3-turbo",
+        "standard/1024-x-1024/dall-e-2",
+      ],
+    },
+    vertex_ai_beta: {
+      separator: "/",
+      models: ["chat-bison", "chat-bison-32k"],
+    },
+    sagemaker: { separator: "/", models: ["meta-textgeneration-llama-2-13b"] },
+    cohere: { separator: ".", models: ["command-r-v1:0"] },
+    cloudflare: {
+      separator: "/",
+      models: ["@cf/mistral/mistral-7b-instruct-v0.1"],
+    },
+    openai: {
+      separator: "/",
+      models: ["gpt-4o", "gpt-4o-mini"],
+    },
+    anthropic: {
+      separator: "/",
+      models: [
+        "claude-3-5-sonnet-20241022",
+        "claude-3-haiku-20240307",
+        "claude-2",
+        "claude-2.1",
+      ],
+    },
+    other: {
+      separator: "",
+      models: ["together-ai-21.1b-41b"],
+    },
+  });
+});

"b/frontend/src/utils/verified-models.ts\""

@@ -0,0 +1,29 @@
+// Here are the list of verified models and providers that we know work well with OpenHands.
+export const VERIFIED_PROVIDERS = ["openai", "azure", "anthropic"];
+export const VERIFIED_MODELS = ["gpt-4o", "claude-3-5-sonnet-20241022"];
+
+// LiteLLM does not return OpenAI models with the provider, so we list them here to set them ourselves for consistency
+// (e.g., they return `gpt-4o` instead of `openai/gpt-4o`)
+export const VERIFIED_OPENAI_MODELS = [
+  "gpt-4o",
+  "gpt-4o-mini",
+  "gpt-4-turbo",
+  "gpt-4",
+  "gpt-4-32k",
+  "o1-mini",
+  "o1-preview",
+];
+
+// LiteLLM does not return the compatible Anthropic models with the provider, so we list them here to set them ourselves
+// (e.g., they return `claude-3-5-sonnet-20241022` instead of `anthropic/claude-3-5-sonnet-20241022`)
+export const VERIFIED_ANTHROPIC_MODELS = [
+  "claude-2",
+  "claude-2.1",
+  "claude-3-5-sonnet-20241022",
+  "claude-3-5-sonnet-20240620",
+  "claude-3-haiku-20240307",
+  "claude-3-opus-20240229",
+  "claude-3-sonnet-20240229",
+  "claude-instant-1",
+  "claude-instant-1.2",
+];

.github/ISSUE_TEMPLATE/bug_template.yml

@@ -31,8 +31,6 @@ body:
       options:
         - Docker command in README
         - Development workflow
-        - app.all-hands.dev
-        - Other
       default: 0
 
   - type: input

.github/workflows/ghcr-build.yml

@@ -1,5 +1,5 @@
 # Workflow that builds, tests and then pushes the OpenHands and runtime docker images to the ghcr.io repository
-name: Docker
+name: Build, Test and Publish RT Image
 
 # Always run on "main"
 # Always run on tags
@@ -286,6 +286,7 @@ jobs:
           image_name=ghcr.io/${{ github.repository_owner }}/runtime:${{ env.RELEVANT_SHA }}-${{ matrix.base_image }}
           image_name=$(echo $image_name | tr '[:upper:]' '[:lower:]')
 
+          SKIP_CONTAINER_LOGS=true \
           TEST_RUNTIME=eventstream \
           SANDBOX_USER_ID=$(id -u) \
           SANDBOX_RUNTIME_CONTAINER_IMAGE=$image_name \
@@ -363,6 +364,7 @@ jobs:
           image_name=ghcr.io/${{ github.repository_owner }}/runtime:${{ env.RELEVANT_SHA }}-${{ matrix.base_image }}
           image_name=$(echo $image_name | tr '[:upper:]' '[:lower:]')
 
+          SKIP_CONTAINER_LOGS=true \
           TEST_RUNTIME=eventstream \
           SANDBOX_USER_ID=$(id -u) \
           SANDBOX_RUNTIME_CONTAINER_IMAGE=$image_name \
@@ -397,49 +399,3 @@ jobs:
         run: |
           echo "Some runtime tests failed or were cancelled"
           exit 1
-  update_pr_description:
-    name: Update PR Description
-    if: github.event_name == 'pull_request' && !github.event.pull_request.head.repo.fork && github.actor != 'dependabot[bot]'
-    needs: [ghcr_build_runtime]
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Get short SHA
-        id: short_sha
-        run: echo "SHORT_SHA=$(echo ${{ github.event.pull_request.head.sha }} | cut -c1-7)" >> $GITHUB_OUTPUT
-
-      - name: Update PR Description
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          PR_NUMBER: ${{ github.event.pull_request.number }}
-          REPO: ${{ github.repository }}
-          SHORT_SHA: ${{ steps.short_sha.outputs.SHORT_SHA }}
-        run: |
-          echo "updating PR description"
-          DOCKER_RUN_COMMAND="docker run -it --rm \
-            -p 3000:3000 \
-            -v /var/run/docker.sock:/var/run/docker.sock \
-            --add-host host.docker.internal:host-gateway \
-            -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:$SHORT_SHA-nikolaik \
-            --name openhands-app-$SHORT_SHA \
-            docker.all-hands.dev/all-hands-ai/openhands:$SHORT_SHA"
-
-          PR_BODY=$(gh pr view $PR_NUMBER --json body --jq .body)
-
-          if echo "$PR_BODY" | grep -q "To run this PR locally, use the following command:"; then
-            UPDATED_PR_BODY=$(echo "${PR_BODY}" | sed -E "s|docker run -it --rm.*|$DOCKER_RUN_COMMAND|")
-          else
-            UPDATED_PR_BODY="${PR_BODY}
-
-          ---
-
-          To run this PR locally, use the following command:
-          \`\`\`
-          $DOCKER_RUN_COMMAND
-          \`\`\`"
-          fi
-
-          echo "updated body: $UPDATED_PR_BODY"
-          gh pr edit $PR_NUMBER --body "$UPDATED_PR_BODY"

.github/workflows/lint-fix.yml

@@ -1,62 +0,0 @@
-name: Lint Fix
-
-on:
-  pull_request:
-    types: [labeled]
-
-jobs:
-  lint-fix:
-    if: github.event.label.name == 'lint-fix'
-    name: Fix linting issues
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ github.head_ref }}
-          repository: ${{ github.event.pull_request.head.repo.full_name }}
-          fetch-depth: 0
-          token: ${{ secrets.GITHUB_TOKEN }}
-
-      # Frontend lint fixes
-      - name: Install Node.js 20
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-      - name: Install frontend dependencies
-        run: |
-          cd frontend
-          npm install --frozen-lockfile
-      - name: Fix frontend lint issues
-        run: |
-          cd frontend
-          npm run lint:fix
-
-      # Python lint fixes
-      - name: Set up python
-        uses: actions/setup-python@v5
-        with:
-          python-version: 3.12
-          cache: 'pip'
-      - name: Install pre-commit
-        run: pip install pre-commit==3.7.0
-      - name: Fix python lint issues
-        run: |
-          # Run all pre-commit hooks and continue even if they modify files (exit code 1)
-          pre-commit run --config ./dev_config/python/.pre-commit-config.yaml --files openhands/**/* evaluation/**/* tests/**/* || true
-
-      # Commit and push changes if any
-      - name: Check for changes
-        id: git-check
-        run: |
-          git diff --quiet || echo "changes=true" >> $GITHUB_OUTPUT
-      - name: Commit and push if there are changes
-        if: steps.git-check.outputs.changes == 'true'
-        run: |
-          git config --local user.email "openhands@all-hands.dev"
-          git config --local user.name "OpenHands Bot"
-          git add -A
-          git commit -m "🤖 Auto-fix linting issues"
-          git push

.github/workflows/openhands-resolver.yml

@@ -1,283 +1,13 @@
-name: Auto-Fix Tagged Issue with OpenHands
+name: Resolve Issues with OpenHands
 
 on:
-  workflow_call:
-    inputs:
-      max_iterations:
-        required: false
-        type: number
-        default: 50
-      macro:
-        required: false
-        type: string
-        default: "@openhands-agent"
-    secrets:
-      LLM_MODEL:
-        required: true
-      LLM_API_KEY:
-        required: true
-      LLM_BASE_URL:
-        required: false
-      PAT_TOKEN:
-        required: true
-      PAT_USERNAME:
-        required: true
-
   issues:
     types: [labeled]
-  pull_request:
-    types: [labeled]
-  issue_comment:
-    types: [created]
-  pull_request_review_comment:
-    types: [created]
-  pull_request_review:
-    types: [submitted]
-
-permissions:
-  contents: write
-  pull-requests: write
-  issues: write
 
 jobs:
-  auto-fix:
-    if: |
-      github.event_name == 'workflow_call' ||
-      github.event.label.name == 'fix-me' ||
-      github.event.label.name == 'fix-me-experimental' ||
-
-      (
-        ((github.event_name == 'issue_comment' || github.event_name == 'pull_request_review_comment') &&
-        startsWith(github.event.comment.body, inputs.macro || '@openhands-agent') &&
-        (github.event.comment.author_association == 'OWNER' || github.event.comment.author_association == 'COLLABORATOR' || github.event.comment.author_association == 'MEMBER')
-        ) ||
-
-        (github.event_name == 'pull_request_review' &&
-        startsWith(github.event.review.body, inputs.macro || '@openhands-agent') &&
-        (github.event.review.author_association == 'OWNER' || github.event.review.author_association == 'COLLABORATOR' || github.event.review.author_association == 'MEMBER')
-        )
-      )
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Get latest versions and create requirements.txt
-        run: |
-          python -m pip index versions openhands-ai > openhands_versions.txt
-          OPENHANDS_VERSION=$(head -n 1 openhands_versions.txt | awk '{print $2}' | tr -d '()')
-          echo "openhands-ai==${OPENHANDS_VERSION}" >> requirements.txt
-          cat requirements.txt
-
-      - name: Cache pip dependencies
-        if: |
-          !(
-            github.event.label.name == 'fix-me-experimental' ||
-            (
-              (github.event_name == 'issue_comment' || github.event_name == 'pull_request_review_comment') &&
-              startsWith(github.event.comment.body, '@openhands-agent-exp')
-            ) ||
-            (
-              github.event_name == 'pull_request_review' &&
-              startsWith(github.event.review.body, '@openhands-agent-exp')
-            )
-          )
-        uses: actions/cache@v3
-        with:
-          path: ${{ env.pythonLocation }}/lib/python3.12/site-packages/*
-          key: ${{ runner.os }}-pip-openhands-resolver-${{ hashFiles('requirements.txt') }}
-          restore-keys: |
-            ${{ runner.os }}-pip-openhands-resolver-${{ hashFiles('requirements.txt') }}
-
-      - name: Check required environment variables
-        env:
-          LLM_MODEL: ${{ secrets.LLM_MODEL }}
-          LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
-          LLM_BASE_URL: ${{ secrets.LLM_BASE_URL }}
-          PAT_TOKEN: ${{ secrets.PAT_TOKEN }}
-          PAT_USERNAME: ${{ secrets.PAT_USERNAME }}
-        run: |
-          required_vars=("LLM_MODEL" "LLM_API_KEY" "PAT_TOKEN" "PAT_USERNAME")
-          for var in "${required_vars[@]}"; do
-            if [ -z "${!var}" ]; then
-              echo "Error: Required environment variable $var is not set."
-              exit 1
-            fi
-          done
-
-      - name: Set environment variables
-        run: |
-          if [ -n "${{ github.event.review.body }}" ]; then
-            echo "ISSUE_NUMBER=${{ github.event.pull_request.number }}" >> $GITHUB_ENV
-            echo "ISSUE_TYPE=pr" >> $GITHUB_ENV
-          elif [ -n "${{ github.event.issue.pull_request }}" ]; then
-            echo "ISSUE_NUMBER=${{ github.event.issue.number }}" >> $GITHUB_ENV
-            echo "ISSUE_TYPE=pr" >> $GITHUB_ENV
-          elif [ -n "${{ github.event.pull_request.number }}" ]; then
-            echo "ISSUE_NUMBER=${{ github.event.pull_request.number }}" >> $GITHUB_ENV
-            echo "ISSUE_TYPE=pr" >> $GITHUB_ENV
-          else
-            echo "ISSUE_NUMBER=${{ github.event.issue.number }}" >> $GITHUB_ENV
-            echo "ISSUE_TYPE=issue" >> $GITHUB_ENV
-          fi
-
-          if [ -n "${{ github.event.review.body }}" ]; then
-            echo "COMMENT_ID=${{ github.event.review.id || 'None' }}" >> $GITHUB_ENV
-          else
-            echo "COMMENT_ID=${{ github.event.comment.id || 'None' }}" >> $GITHUB_ENV
-          fi
-
-          echo "MAX_ITERATIONS=${{ inputs.max_iterations || 50 }}" >> $GITHUB_ENV
-          echo "SANDBOX_ENV_GITHUB_TOKEN=${{ secrets.GITHUB_TOKEN }}" >> $GITHUB_ENV
-
-      - name: Comment on issue with start message
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{secrets.GITHUB_TOKEN}}
-          script: |
-            const issueType = process.env.ISSUE_TYPE;
-            github.rest.issues.createComment({
-              issue_number: ${{ env.ISSUE_NUMBER }},
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: `[OpenHands](https://github.com/All-Hands-AI/OpenHands) started fixing the ${issueType}! You can monitor the progress [here](https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId}).`
-            });
-
-      - name: Install OpenHands
-        run: |
-          if [[ "${{ github.event.label.name }}" == "fix-me-experimental" ]] ||
-             ([[ "${{ github.event_name }}" == "issue_comment" || "${{ github.event_name }}" == "pull_request_review_comment" ]] &&
-              [[ "${{ github.event.comment.body }}" == "@openhands-agent-exp"* ]]) ||
-             ([[ "${{ github.event_name }}" == "pull_request_review" ]] &&
-              [[ "${{ github.event.review.body }}" == "@openhands-agent-exp"* ]]); then
-            python -m pip install --upgrade pip
-            pip install git+https://github.com/all-hands-ai/openhands.git
-          else
-            python -m pip install --upgrade -r requirements.txt
-          fi
-
-      - name: Attempt to resolve issue
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GITHUB_USERNAME: ${{ secrets.PAT_USERNAME }}
-          LLM_MODEL: ${{ secrets.LLM_MODEL }}
-          LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
-          LLM_BASE_URL: ${{ secrets.LLM_BASE_URL }}
-          PYTHONPATH: ""
-        run: |
-          cd /tmp && python -m openhands.resolver.resolve_issue \
-            --repo ${{ github.repository }} \
-            --issue-number ${{ env.ISSUE_NUMBER }} \
-            --issue-type ${{ env.ISSUE_TYPE }} \
-            --max-iterations ${{ env.MAX_ITERATIONS }} \
-            --comment-id ${{ env.COMMENT_ID }}
-
-      - name: Check resolution result
-        id: check_result
-        run: |
-          if cd /tmp && grep -q '"success":true' output/output.jsonl; then
-            echo "RESOLUTION_SUCCESS=true" >> $GITHUB_OUTPUT
-          else
-            echo "RESOLUTION_SUCCESS=false" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Upload output.jsonl as artifact
-        uses: actions/upload-artifact@v4
-        if: always() # Upload even if the previous steps fail
-        with:
-          name: resolver-output
-          path: /tmp/output/output.jsonl
-          retention-days: 30 # Keep the artifact for 30 days
-
-      - name: Create draft PR or push branch
-        if: always() # Create PR or branch even if the previous steps fail
-        env:
-          GITHUB_TOKEN: ${{ secrets.PAT_TOKEN }}
-          GITHUB_USERNAME: ${{ secrets.PAT_USERNAME }}
-          LLM_MODEL: ${{ secrets.LLM_MODEL }}
-          LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
-          LLM_BASE_URL: ${{ secrets.LLM_BASE_URL }}
-          PYTHONPATH: ""
-        run: |
-          if [ "${{ steps.check_result.outputs.RESOLUTION_SUCCESS }}" == "true" ]; then
-            cd /tmp && python -m openhands.resolver.send_pull_request \
-              --issue-number ${{ env.ISSUE_NUMBER }} \
-              --pr-type draft | tee pr_result.txt && \
-              grep "draft created" pr_result.txt | sed 's/.*\///g' > pr_number.txt
-          else
-            cd /tmp && python -m openhands.resolver.send_pull_request \
-              --issue-number ${{ env.ISSUE_NUMBER }} \
-              --pr-type branch \
-              --send-on-failure | tee branch_result.txt && \
-              grep "branch created" branch_result.txt | sed 's/.*\///g; s/.expand=1//g' > branch_name.txt
-          fi
-
-      - name: Comment on issue
-        uses: actions/github-script@v7
-        if: always() # Comment on issue even if the previous steps fail
-        with:
-          github-token: ${{secrets.GITHUB_TOKEN}}
-          script: |
-            const fs = require('fs');
-            const issueNumber = ${{ env.ISSUE_NUMBER }};
-            const success = ${{ steps.check_result.outputs.RESOLUTION_SUCCESS }};
-
-            let prNumber = '';
-            let branchName = '';
-            let logContent = '';
-            const noChangesMessage = `No changes to commit for issue #${issueNumber}. Skipping commit.`;
-
-            try {
-              if (success){
-                logContent = fs.readFileSync('/tmp/pr_result.txt', 'utf8').trim();
-              } else {
-                logContent = fs.readFileSync('/tmp/branch_result.txt', 'utf8').trim();
-              }
-            } catch (error) {
-              console.error('Error reading results file:', error);
-            }
-
-            try {
-              if (success) {
-                prNumber = fs.readFileSync('/tmp/pr_number.txt', 'utf8').trim();
-              } else {
-                branchName = fs.readFileSync('/tmp/branch_name.txt', 'utf8').trim();
-              }
-            } catch (error) {
-              console.error('Error reading file:', error);
-            }
-
-            if (logContent.includes(noChangesMessage)) {
-              github.rest.issues.createComment({
-                issue_number: issueNumber,
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                body: `The workflow to fix this issue encountered an error. Openhands failed to create any code changes.`
-              });
-            } else if (success && prNumber) {
-              github.rest.issues.createComment({
-                issue_number: issueNumber,
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                body: `A potential fix has been generated and a draft PR #${prNumber} has been created. Please review the changes.`
-              });
-            } else if (!success && branchName) {
-              github.rest.issues.createComment({
-                issue_number: issueNumber,
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                body: `An attempt was made to automatically fix this issue, but it was unsuccessful. A branch named '${branchName}' has been created with the attempted changes. You can view the branch [here](https://github.com/${context.repo.owner}/${context.repo.repo}/tree/${branchName}). Manual intervention may be required.`
-              });
-            } else {
-              github.rest.issues.createComment({
-                issue_number: issueNumber,
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                body: `The workflow to fix this issue encountered an error. Please check the [workflow logs](https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId}) for more information.`
-              });
-            }
+  call-openhands-resolver:
+    uses: All-Hands-AI/openhands-resolver/.github/workflows/openhands-resolver.yml@main
+    if: github.event.label.name == 'fix-me'
+    with:
+      issue_number: ${{ github.event.issue.number }}
+    secrets: inherit

.gitignore

@@ -174,10 +174,6 @@ evaluation/bird/data
 evaluation/gaia/data
 evaluation/gorilla/data
 evaluation/toolqa/data
-evaluation/scienceagentbench/benchmark
-
-# openhands resolver
-output/
 
 # frontend
 

COMMUNITY.md

@@ -1,43 +0,0 @@
-# 🙌 The OpenHands Community
-
-The OpenHands community is built around the belief that (1) AI and AI agents are going to fundamentally change the way
-we build software, and (2) if this is true, we should do everything we can to make sure that the benefits provided by
-such powerful technology are accessible to everyone.
-
-If this resonates with you, we'd love to have you join us in our quest!
-
-## 🤝 How to Join
-
-Check out our [How to Join the Community section.](https://github.com/All-Hands-AI/OpenHands?tab=readme-ov-file#-how-to-join-the-community)
-
-## 💪 Becoming a Contributor
-
-We welcome contributions from everyone! Whether you're a developer, a researcher, or simply enthusiastic about advancing
-the field of software engineering with AI, there are many ways to get involved:
-
-- **Code Contributions:** Help us develop new core functionality, improve our agents, improve the frontend and other
-interfaces, or anything else that would help make OpenHands better.
-- **Research and Evaluation:** Contribute to our understanding of LLMs in software engineering, participate in
-evaluating the models, or suggest improvements.
-- **Feedback and Testing:** Use the OpenHands toolset, report bugs, suggest features, or provide feedback on usability.
-
-For details, please check [CONTRIBUTING.md](./CONTRIBUTING.md).
-
-## Code of Conduct
-
-We have a [Code of Conduct](./CODE_OF_CONDUCT.md) that we expect all contributors to adhere to.
-Long story short, we are aiming for an open, welcoming, diverse, inclusive, and healthy community.
-All contributors are expected to contribute to building this sort of community.
-
-## 🛠️ Becoming a Maintainer
-
-For contributors who have made significant and sustained contributions to the project, there is a possibility of joining
-the maintainer team. The process for this is as follows:
-
-1. Any contributor who has made sustained and high-quality contributions to the codebase can be nominated by any
-maintainer. If you feel that you may qualify you can reach out to any of the maintainers that have reviewed your PRs and ask if you can be nominated.
-2. Once a maintainer nominates a new maintainer, there will be a discussion period among the maintainers for at least 3 days.
-3. If no concerns are raised the nomination will be accepted by acclamation, and if concerns are raised there will be a discussion and possible vote.
-
-Note that just making many PRs does not immediately imply that you will become a maintainer. We will be looking
-at sustained high-quality contributions over a period of time, as well as good teamwork and adherence to our [Code of Conduct](./CODE_OF_CONDUCT.md).

CONTRIBUTING.md

@@ -54,7 +54,7 @@ The agent needs a place to run code and commands. When you run OpenHands on your
 to do this by default. But there are other ways of creating a sandbox for the agent.
 
 If you work for a company that provides a cloud-based runtime, you could help us add support for that runtime
-by implementing the [interface specified here](https://github.com/All-Hands-AI/OpenHands/blob/main/openhands/runtime/base.py).
+by implementing the [interface specified here](https://github.com/All-Hands-AI/OpenHands/blob/main/openhands/runtime/runtime.py).
 
 #### Testing
 When you write code, it is also good to write tests. Please navigate to the `tests` folder to see existing test suites.
@@ -92,32 +92,3 @@ You may also check out previous PRs in the [PR list](https://github.com/All-Hand
 
 If your changes are user-facing (e.g. a new feature in the UI, a change in behavior, or a bugfix)
 please include a short message that we can add to our changelog.
-
-## How to Make Effective Contributions
-
-### Opening Issues
-
-If you notice any bugs or have any feature requests please open them via the [issues page](https://github.com/All-Hands-AI/OpenHands/issues). We will triage based on how critical the bug is or how potentially useful the improvement is, discuss, and implement the ones that the community has interest/effort for.
-
-Further, if you see an issue you like, please leave a "thumbs-up" or a comment, which will help us prioritize.
-
-### Making Pull Requests
-
-We're generally happy to consider all PRs, with the evaluation process varying based on the type of change:
-
-#### For Small Improvements
-
-Small improvements with few downsides are typically reviewed and approved quickly.
-One thing to check when making changes is to ensure that all continuous integration tests pass, which you can check before getting a review.
-
-#### For Core Agent Changes
-
-We need to be more careful with changes to the core agent, as it is imperative to maintain high quality. These PRs are evaluated based on three key metrics:
-
-1. **Accuracy**
-2. **Efficiency**
-3. **Code Complexity**
-
-If it improves accuracy, efficiency, or both with only a minimal change to code quality, that's great we're happy to merge it in!
-If there are bigger tradeoffs (e.g. helping efficiency a lot and hurting accuracy a little) we might want to put it behind a feature flag.
-Either way, please feel free to discuss on github issues or slack, and we will give guidance and preliminary feedback.

Development.md

@@ -38,9 +38,7 @@ make build
 ```
 
 ### 3. Configuring the Language Model
-OpenHands supports a diverse array of Language Models (LMs) through the powerful [litellm](https://docs.litellm.ai) library.
-By default, we've chosen Claude Sonnet 3.5 as our go-to model, but the world is your oyster! You can unleash the
-potential of any other LM that piques your interest.
+OpenHands supports a diverse array of Language Models (LMs) through the powerful [litellm](https://docs.litellm.ai) library. By default, we've chosen the mighty GPT-4 from OpenAI as our go-to model, but the world is your oyster! You can unleash the potential of Anthropic's suave Claude, the enigmatic Llama, or any other LM that piques your interest.
 
 To configure the LM of your choice, run:
 
@@ -54,7 +52,10 @@ To configure the LM of your choice, run:
    Environment variables > config.toml variables > default variables
 
 **Note on Alternative Models:**
-See [our documentation](https://docs.all-hands.dev/modules/usage/llms) for recommended models.
+Some alternative models may prove more challenging to tame than others. Fear not, brave adventurer! We shall soon unveil LLM-specific documentation to guide you on your quest.
+And if you've already mastered the art of wielding a model other than OpenAI's GPT, we encourage you to share your setup instructions with us by creating instructions and adding it [to our documentation](https://github.com/All-Hands-AI/OpenHands/tree/main/docs/modules/usage/llms).
+
+For a full list of the LM providers and models available, please consult the [litellm documentation](https://docs.litellm.ai/docs/providers).
 
 ### 4. Running the application
 #### Option A: Run the Full Application
@@ -97,10 +98,9 @@ poetry run pytest ./tests/unit/test_*.py
 2. Update the poetry.lock file via `poetry lock --no-update`
 
 ### 9. Use existing Docker image
-To reduce build time (e.g., if no changes were made to the client-runtime component), you can use an existing Docker container image by
-setting the SANDBOX_RUNTIME_CONTAINER_IMAGE environment variable to the desired Docker image.
-
-Example: `export SANDBOX_RUNTIME_CONTAINER_IMAGE=ghcr.io/all-hands-ai/runtime:0.14-nikolaik`
+To reduce build time (e.g., if no changes were made to the client-runtime component), you can use an existing Docker container image. Follow these steps:
+1. Set the SANDBOX_RUNTIME_CONTAINER_IMAGE environment variable to the desired Docker image.
+2. Example: export SANDBOX_RUNTIME_CONTAINER_IMAGE=ghcr.io/all-hands-ai/runtime:0.9-nikolaik
 
 ## Develop inside Docker container
 

ISSUE_TRIAGE.md

@@ -6,9 +6,9 @@ These are the procedures and guidelines on how issues are triaged in this repo b
 * Issues may be tagged with what it relates to (**backend**, **frontend**, **agent quality**, etc.)
 
 ## Severity
-* **Low**: Minor issues or affecting single user.
-* **Medium**: Affecting multiple users.
-* **Critical**: Affecting all users or potential security issues.
+* **Low**: Minor issues, single user report
+* **Medium**: Affecting multiple users
+* **Critical**: Affecting all users or potential security issues
 
 ## Effort
 * Issues may be estimated with effort required (**small effort**, **medium effort**, **large effort**)
@@ -17,9 +17,9 @@ These are the procedures and guidelines on how issues are triaged in this repo b
 * Issues with low implementation difficulty may be tagged with **good first issue**
 
 ## Not Enough Information
-* User is asked to provide more information (logs, how to reproduce, etc.) when the issue is not clear.
-* If an issue is unclear and the author does not provide more information or respond to a request, the issue may be closed as **not planned** (Usually after a week).
+* User is asked to provide more information (logs, how to reproduce, etc.) when the issue is not clear
+* If an issue is unclear and the author does not provide more information or respond to a request, the issue may be closed as **not planned** (Usually after a week)
 
 ## Multiple Requests/Fixes in One Issue
-* These issues will be narrowed down to one request/fix so the issue is more easily tracked and fixed.
-* Issues may be broken down into multiple issues if required.
+* These issues will be narrowed down to one request/fix so the issue is more easily tracked and fixed
+* Issues may be broken down into multiple issues if required

README.md

@@ -12,7 +12,7 @@
   <a href="https://codecov.io/github/All-Hands-AI/OpenHands?branch=main"><img alt="CodeCov" src="https://img.shields.io/codecov/c/github/All-Hands-AI/OpenHands?style=for-the-badge&color=blue"></a>
   <a href="https://github.com/All-Hands-AI/OpenHands/blob/main/LICENSE"><img src="https://img.shields.io/github/license/All-Hands-AI/OpenHands?style=for-the-badge&color=blue" alt="MIT License"></a>
   <br/>
-  <a href="https://join.slack.com/t/openhands-ai/shared_invite/zt-2tom0er4l-JeNUGHt_AxpEfIBstbLPiw"><img src="https://img.shields.io/badge/Slack-Join%20Us-red?logo=slack&logoColor=white&style=for-the-badge" alt="Join our Slack community"></a>
+  <a href="https://join.slack.com/t/opendevin/shared_invite/zt-2oikve2hu-UDxHeo8nsE69y6T7yFX_BA"><img src="https://img.shields.io/badge/Slack-Join%20Us-red?logo=slack&logoColor=white&style=for-the-badge" alt="Join our Slack community"></a>
   <a href="https://discord.gg/ESHStjSjD4"><img src="https://img.shields.io/badge/Discord-Join%20Us-purple?logo=discord&logoColor=white&style=for-the-badge" alt="Join our Discord community"></a>
   <a href="https://github.com/All-Hands-AI/OpenHands/blob/main/CREDITS.md"><img src="https://img.shields.io/badge/Project-Credits-blue?style=for-the-badge&color=FFE165&logo=github&logoColor=white" alt="Credits"></a>
   <br/>
@@ -33,35 +33,37 @@ Learn more at [docs.all-hands.dev](https://docs.all-hands.dev), or jump to the [
 
 ## ⚡ Quick Start
 
-The easiest way to run OpenHands is in Docker.
+The easiest way to run OpenHands is in Docker. You can change `WORKSPACE_BASE` below to
+point OpenHands to existing code that you'd like to modify.
+
 See the [Installation](https://docs.all-hands.dev/modules/usage/installation) guide for
 system requirements and more information.
 
 ```bash
-docker pull docker.all-hands.dev/all-hands-ai/runtime:0.14-nikolaik
+export WORKSPACE_BASE=$(pwd)/workspace
+
+docker pull ghcr.io/all-hands-ai/runtime:0.11-nikolaik
 
 docker run -it --pull=always \
-    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.14-nikolaik \
-    -e LOG_ALL_EVENTS=true \
+    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=ghcr.io/all-hands-ai/runtime:0.11-nikolaik \
+    -e SANDBOX_USER_ID=$(id -u) \
+    -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
+    -v $WORKSPACE_BASE:/opt/workspace_base \
     -v /var/run/docker.sock:/var/run/docker.sock \
     -p 3000:3000 \
     --add-host host.docker.internal:host-gateway \
-    --name openhands-app \
-    docker.all-hands.dev/all-hands-ai/openhands:0.14
+    --name openhands-app-$(date +%Y%m%d%H%M%S) \
+    ghcr.io/all-hands-ai/openhands:0.11
 ```
 
 You'll find OpenHands running at [http://localhost:3000](http://localhost:3000)!
 
-Finally, you'll need a model provider and API key.
-[Anthropic's Claude 3.5 Sonnet](https://www.anthropic.com/api) (`anthropic/claude-3-5-sonnet-20241022`)
-works best, but you have [many options](https://docs.all-hands.dev/modules/usage/llms).
+You'll need a model provider and API key. One option that works well: [Claude 3.5 Sonnet](https://www.anthropic.com/api), but you have [many options](https://docs.all-hands.dev/modules/usage/llms).
 
 ---
 
-You can also [connect OpenHands to your local filesystem](https://docs.all-hands.dev/modules/usage/runtimes),
-run OpenHands in a scriptable [headless mode](https://docs.all-hands.dev/modules/usage/how-to/headless-mode),
-interact with it via a [friendly CLI](https://docs.all-hands.dev/modules/usage/how-to/cli-mode),
-or run it on tagged issues with [a github action](https://github.com/All-Hands-AI/OpenHands/blob/main/openhands/resolver/README.md).
+You can also run OpenHands in a scriptable [headless mode](https://docs.all-hands.dev/modules/usage/how-to/headless-mode),
+or as an [interactive CLI](https://docs.all-hands.dev/modules/usage/how-to/cli-mode).
 
 Visit [Installation](https://docs.all-hands.dev/modules/usage/installation) for more information and setup instructions.
 
@@ -77,16 +79,25 @@ To learn more about the project, and for tips on using OpenHands,
 There you'll find resources on how to use different LLM providers,
 troubleshooting resources, and advanced configuration options.
 
-## 🤝 How to Join the Community
+## 🤝 How to Contribute
 
-OpenHands is a community-driven project, and we welcome contributions from everyone. We do most of our communication
-through Slack, so this is the best place to start, but we also are happy to have you contact us on Discord or Github:
+OpenHands is a community-driven project, and we welcome contributions from everyone.
+Whether you're a developer, a researcher, or simply enthusiastic about advancing the field of
+software engineering with AI, there are many ways to get involved:
 
-- [Join our Slack workspace](https://join.slack.com/t/openhands-ai/shared_invite/zt-2tom0er4l-JeNUGHt_AxpEfIBstbLPiw) - Here we talk about research, architecture, and future development.
-- [Join our Discord server](https://discord.gg/ESHStjSjD4) - This is a community-run server for general discussion, questions, and feedback.
-- [Read or post Github Issues](https://github.com/All-Hands-AI/OpenHands/issues) - Check out the issues we're working on, or add your own ideas.
+- **Code Contributions:** Help us develop new agents, core functionality, the frontend and other interfaces, or sandboxing solutions.
+- **Research and Evaluation:** Contribute to our understanding of LLMs in software engineering, participate in evaluating the models, or suggest improvements.
+- **Feedback and Testing:** Use the OpenHands toolset, report bugs, suggest features, or provide feedback on usability.
 
-See more about the community in [COMMUNITY.md](./COMMUNITY.md) or find details on contributing in [CONTRIBUTING.md](./CONTRIBUTING.md).
+For details, please check [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## 🤖 Join Our Community
+
+Whether you're a developer, a researcher, or simply enthusiastic about OpenHands, we'd love to have you in our community.
+Let's make software engineering better together!
+
+- [Slack workspace](https://join.slack.com/t/opendevin/shared_invite/zt-2oikve2hu-UDxHeo8nsE69y6T7yFX_BA) - Here we talk about research, architecture, and future development.
+- [Discord server](https://discord.gg/ESHStjSjD4) - This is a community-run server for general discussion, questions, and feedback.
 
 ## 📈 Progress
 

compose.yml

@@ -7,7 +7,7 @@ services:
     image: openhands:latest
     container_name: openhands-app-${DATE:-}
     environment:
-      - SANDBOX_RUNTIME_CONTAINER_IMAGE=${SANDBOX_RUNTIME_CONTAINER_IMAGE:-ghcr.io/all-hands-ai/runtime:0.14-nikolaik}
+      - SANDBOX_RUNTIME_CONTAINER_IMAGE=${SANDBOX_RUNTIME_CONTAINER_IMAGE:-ghcr.io/all-hands-ai/runtime:0.9-nikolaik}
       - SANDBOX_USER_ID=${SANDBOX_USER_ID:-1234}
       - WORKSPACE_MOUNT_PATH=${WORKSPACE_BASE:-$PWD/workspace}
     ports:

config.template.toml

@@ -32,8 +32,7 @@ workspace_base = "./workspace"
 # Enable saving and restoring the session when run from CLI
 #enable_cli_session = false
 
-# Path to store trajectories, can be a folder or a file
-# If it's a folder, the session id will be used as the file name
+# Path to store trajectories
 #trajectories_path="./trajectories"
 
 # File store path

containers/app/Dockerfile

@@ -41,7 +41,6 @@ ENV SANDBOX_LOCAL_RUNTIME_URL=http://host.docker.internal
 ENV USE_HOST_NETWORK=false
 ENV WORKSPACE_BASE=/opt/workspace_base
 ENV OPENHANDS_BUILD_VERSION=$OPENHANDS_BUILD_VERSION
-ENV SANDBOX_USER_ID=0
 RUN mkdir -p $WORKSPACE_BASE
 
 RUN apt-get update -y \

containers/app/entrypoint.sh

@@ -18,11 +18,6 @@ if [ -z "$SANDBOX_USER_ID" ]; then
   exit 1
 fi
 
-if [ -z "$WORKSPACE_MOUNT_PATH" ]; then
-  # This is set to /opt/workspace in the Dockerfile. But if the user isn't mounting, we want to unset it so that OpenHands doesn't mount at all
-  unset WORKSPACE_BASE
-fi
-
 if [[ "$SANDBOX_USER_ID" -eq 0 ]]; then
   echo "Running OpenHands as root"
   export RUN_AS_OPENHANDS=false

containers/dev/compose.yml

@@ -11,7 +11,7 @@ services:
       - BACKEND_HOST=${BACKEND_HOST:-"0.0.0.0"}
       - SANDBOX_API_HOSTNAME=host.docker.internal
       #
-      - SANDBOX_RUNTIME_CONTAINER_IMAGE=${SANDBOX_RUNTIME_CONTAINER_IMAGE:-ghcr.io/all-hands-ai/runtime:0.14-nikolaik}
+      - SANDBOX_RUNTIME_CONTAINER_IMAGE=${SANDBOX_RUNTIME_CONTAINER_IMAGE:-ghcr.io/all-hands-ai/runtime:0.9-nikolaik}
       - SANDBOX_USER_ID=${SANDBOX_USER_ID:-1234}
       - WORKSPACE_MOUNT_PATH=${WORKSPACE_BASE:-$PWD/workspace}
     ports:

docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/cli-mode.md

@@ -14,97 +14,4 @@ Pour démarrer une session OpenHands interactive via la ligne de commande, suive
 
 2. Exécutez la commande suivante :
 
-```bash
-poetry run python -m openhands.core.cli
-```
 
-Cette commande démarrera une session interactive où vous pourrez saisir des tâches et recevoir des réponses d'OpenHands.
-
-Vous devrez vous assurer de définir votre modèle, votre clé API et d'autres paramètres via des variables d'environnement
-[ou le fichier `config.toml`](https://github.com/All-Hands-AI/OpenHands/blob/main/config.template.toml).
-
-
-## Avec Docker
-
-Pour exécuter OpenHands en mode CLI avec Docker, suivez ces étapes :
-
-1. Définissez `WORKSPACE_BASE` sur le répertoire que vous souhaitez qu'OpenHands modifie :
-
-```bash
-WORKSPACE_BASE=$(pwd)/workspace
-```
-
-2. Définissez `LLM_MODEL` sur le modèle que vous souhaitez utiliser :
-
-```bash
-LLM_MODEL="anthropic/claude-3-5-sonnet-20241022"
-```
-
-3. Définissez `LLM_API_KEY` sur votre clé API :
-
-```bash
-LLM_API_KEY="sk_test_12345"
-```
-
-4. Exécutez la commande Docker suivante :
-
-```bash
-docker run -it \
-    --pull=always \
-    -e SANDBOX_USER_ID=$(id -u) \
-    -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
-    -e LLM_API_KEY=$LLM_API_KEY \
-    -e LLM_MODEL=$LLM_MODEL \
-    -v $WORKSPACE_BASE:/opt/workspace_base \
-    -v /var/run/docker.sock:/var/run/docker.sock \
-    --add-host host.docker.internal:host-gateway \
-    --name openhands-app-$(date +%Y%m%d%H%M%S) \
-    ghcr.io/all-hands-ai/openhands:0.11 \
-    python -m openhands.core.cli
-```
-
-Cette commande démarrera une session interactive dans Docker où vous pourrez saisir des tâches et recevoir des réponses d'OpenHands.
-
-## Exemples de commandes CLI et de sorties attendues
-
-Voici quelques exemples de commandes CLI et leurs sorties attendues :
-
-### Exemple 1 : Tâche simple
-
-```bash
-Comment puis-je vous aider ? >> Écrivez un script Python qui affiche "Hello, World!"
-```
-
-Sortie attendue :
-
-```bash
-🤖 Bien sûr ! Voici un script Python qui affiche "Hello, World!" :
-
-❯ print("Hello, World!")
-```
-
-### Exemple 2 : Commande Bash
-
-```bash
-Comment puis-je vous aider ? >> Créez un répertoire nommé "test_dir"
-```
-
-Sortie attendue :
-
-```bash
-🤖 Création d'un répertoire nommé "test_dir" :
-
-❯ mkdir test_dir
-```
-
-### Exemple 3 : Gestion des erreurs
-
-```bash
-Comment puis-je vous aider ? >> Supprimez un fichier inexistant
-```
-
-Sortie attendue :
-
-```bash
-🤖 Une erreur s'est produite. Veuillez réessayer.
-```

docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/evaluation-harness.md

@@ -1,5 +1,3 @@
-
-
 # Évaluation
 
 Ce guide fournit un aperçu de la façon d'intégrer votre propre benchmark d'évaluation dans le framework OpenHands.
@@ -11,271 +9,4 @@ OpenHands en mode développement utilise `config.toml` pour garder une trace de
 
 Voici un exemple de fichier de configuration que vous pouvez utiliser pour définir et utiliser plusieurs LLMs :
 
-```toml
-[llm]
-# IMPORTANT : ajoutez votre clé API ici et définissez le modèle que vous souhaitez évaluer
-model = "claude-3-5-sonnet-20241022"
 
-api_key = "sk-XXX"
-
-[llm.eval_gpt4_1106_preview_llm]
-model = "gpt-4-1106-preview"
-api_key = "XXX"
-temperature = 0.0
-
-[llm.eval_some_openai_compatible_model_llm]
-model = "openai/MODEL_NAME"
-base_url = "https://OPENAI_COMPATIBLE_URL/v1"
-api_key = "XXX"
-temperature = 0.0
-```
-
-
-## Comment utiliser OpenHands en ligne de commande
-
-OpenHands peut être exécuté depuis la ligne de commande en utilisant le format suivant :
-
-```bash
-poetry run python ./openhands/core/main.py \
-        -i <max_iterations> \
-        -t "<task_description>" \
-        -c <agent_class> \
-        -l <llm_config>
-```
-
-Par exemple :
-
-```bash
-poetry run python ./openhands/core/main.py \
-        -i 10 \
-        -t "Écrivez-moi un script bash qui affiche hello world." \
-        -c CodeActAgent \
-        -l llm
-```
-
-Cette commande exécute OpenHands avec :
-- Un maximum de 10 itérations
-- La description de tâche spécifiée
-- En utilisant CodeActAgent
-- Avec la configuration LLM définie dans la section `llm` de votre fichier `config.toml`
-
-## Comment fonctionne OpenHands
-
-Le point d'entrée principal d'OpenHands se trouve dans `openhands/core/main.py`. Voici un flux simplifié de son fonctionnement :
-
-1. Analyse des arguments de ligne de commande et chargement de la configuration
-2. Création d'un environnement d'exécution à l'aide de `create_runtime()`
-3. Initialisation de l'agent spécifié
-4. Exécution du contrôleur à l'aide de `run_controller()`, qui :
-   - Attache l'environnement d'exécution à l'agent
-   - Exécute la tâche de l'agent
-   - Renvoie un état final une fois terminé
-
-La fonction `run_controller()` est le cœur de l'exécution d'OpenHands. Elle gère l'interaction entre l'agent, l'environnement d'exécution et la tâche, en gérant des choses comme la simulation d'entrée utilisateur et le traitement des événements.
-
-
-## Le moyen le plus simple de commencer : Explorer les benchmarks existants
-
-Nous vous encourageons à examiner les différents benchmarks d'évaluation disponibles dans le [répertoire `evaluation/`](https://github.com/All-Hands-AI/OpenHands/blob/main/evaluation) de notre dépôt.
-
-Pour intégrer votre propre benchmark, nous vous suggérons de commencer par celui qui ressemble le plus à vos besoins. Cette approche peut considérablement rationaliser votre processus d'intégration, vous permettant de vous appuyer sur les structures existantes et de les adapter à vos exigences spécifiques.
-
-## Comment créer un workflow d'évaluation
-
-
-Pour créer un workflow d'évaluation pour votre benchmark, suivez ces étapes :
-
-1. Importez les utilitaires OpenHands pertinents :
-   ```python
-    import openhands.agenthub
-    from evaluation.utils.shared import (
-        EvalMetadata,
-        EvalOutput,
-        make_metadata,
-        prepare_dataset,
-        reset_logger_for_multiprocessing,
-        run_evaluation,
-    )
-    from openhands.controller.state.state import State
-    from openhands.core.config import (
-        AppConfig,
-        SandboxConfig,
-        get_llm_config_arg,
-        parse_arguments,
-    )
-    from openhands.core.logger import openhands_logger as logger
-    from openhands.core.main import create_runtime, run_controller
-    from openhands.events.action import CmdRunAction
-    from openhands.events.observation import CmdOutputObservation, ErrorObservation
-    from openhands.runtime.runtime import Runtime
-   ```
-
-2. Créez une configuration :
-   ```python
-   def get_config(instance: pd.Series, metadata: EvalMetadata) -> AppConfig:
-       config = AppConfig(
-           default_agent=metadata.agent_class,
-           runtime='eventstream',
-           max_iterations=metadata.max_iterations,
-           sandbox=SandboxConfig(
-               base_container_image='your_container_image',
-               enable_auto_lint=True,
-               timeout=300,
-           ),
-       )
-       config.set_llm_config(metadata.llm_config)
-       return config
-   ```
-
-3. Initialisez l'environnement d'exécution et configurez l'environnement d'évaluation :
-   ```python
-   def initialize_runtime(runtime: Runtime, instance: pd.Series):
-       # Configurez votre environnement d'évaluation ici
-       # Par exemple, définir des variables d'environnement, préparer des fichiers, etc.
-       pass
-   ```
-
-4. Créez une fonction pour traiter chaque instance :
-   ```python
-   from openhands.utils.async_utils import call_async_from_sync
-   def process_instance(instance: pd.Series, metadata: EvalMetadata) -> EvalOutput:
-       config = get_config(instance, metadata)
-       runtime = create_runtime(config)
-       call_async_from_sync(runtime.connect)
-       initialize_runtime(runtime, instance)
-
-       instruction = get_instruction(instance, metadata)
-
-       state = run_controller(
-           config=config,
-           task_str=instruction,
-           runtime=runtime,
-           fake_user_response_fn=your_user_response_function,
-       )
-
-       # Évaluez les actions de l'agent
-       evaluation_result = await evaluate_agent_actions(runtime, instance)
-
-       return EvalOutput(
-           instance_id=instance.instance_id,
-           instruction=instruction,
-           test_result=evaluation_result,
-           metadata=metadata,
-           history=compatibility_for_eval_history_pairs(state.history),
-           metrics=state.metrics.get() if state.metrics else None,
-           error=state.last_error if state and state.last_error else None,
-       )
-   ```
-
-5. Exécutez l'évaluation :
-   ```python
-   metadata = make_metadata(llm_config, dataset_name, agent_class, max_iterations, eval_note, eval_output_dir)
-   output_file = os.path.join(metadata.eval_output_dir, 'output.jsonl')
-   instances = prepare_dataset(your_dataset, output_file, eval_n_limit)
-
-   await run_evaluation(
-       instances,
-       metadata,
-       output_file,
-       num_workers,
-       process_instance
-   )
-   ```
-
-Ce workflow configure la configuration, initialise l'environnement d'exécution, traite chaque instance en exécutant l'agent et en évaluant ses actions, puis collecte les résultats dans un objet `EvalOutput`. La fonction `run_evaluation` gère la parallélisation et le suivi de la progression.
-
-N'oubliez pas de personnaliser les fonctions `get_instruction`, `your_user_response_function` et `evaluate_agent_actions` en fonction des exigences spécifiques de votre benchmark.
-
-En suivant cette structure, vous pouvez créer un workflow d'évaluation robuste pour votre benchmark dans le framework OpenHands.
-
-
-## Comprendre la `user_response_fn`
-
-La `user_response_fn` est un composant crucial dans le workflow d'évaluation d'OpenHands. Elle simule l'interaction de l'utilisateur avec l'agent, permettant des réponses automatisées pendant le processus d'évaluation. Cette fonction est particulièrement utile lorsque vous souhaitez fournir des réponses cohérentes et prédéfinies aux requêtes ou actions de l'agent.
-
-
-### Workflow et interaction
-
-Le workflow correct pour gérer les actions et la `user_response_fn` est le suivant :
-
-1. L'agent reçoit une tâche et commence à la traiter
-2. L'agent émet une Action
-3. Si l'Action est exécutable (par exemple, CmdRunAction, IPythonRunCellAction) :
-   - Le Runtime traite l'Action
-   - Le Runtime renvoie une Observation
-4. Si l'Action n'est pas exécutable (généralement une MessageAction) :
-   - La `user_response_fn` est appelée
-   - Elle renvoie une réponse utilisateur simulée
-5. L'agent reçoit soit l'Observation, soit la réponse simulée
-6. Les étapes 2 à 5 se répètent jusqu'à ce que la tâche soit terminée ou que le nombre maximum d'itérations soit atteint
-
-Voici une représentation visuelle plus précise :
-
-```
-                 [Agent]
-                    |
-                    v
-               [Émettre une Action]
-                    |
-                    v
-            [L'Action est-elle exécutable ?]
-           /                       \
-         Oui                        Non
-          |                          |
-          v                          v
-     [Runtime]               [user_response_fn]
-          |                          |
-          v                          v
-  [Renvoyer une Observation]    [Réponse simulée]
-           \                        /
-            \                      /
-             v                    v
-           [L'agent reçoit le feedback]
-                    |
-                    v
-         [Continuer ou terminer la tâche]
-```
-
-Dans ce workflow :
-
-- Les actions exécutables (comme l'exécution de commandes ou de code) sont gérées directement par le Runtime
-- Les actions non exécutables (généralement lorsque l'agent veut communiquer ou demander des clarifications) sont gérées par la `user_response_fn`
-- L'agent traite ensuite le feedback, qu'il s'agisse d'une Observation du Runtime ou d'une réponse simulée de la `user_response_fn`
-
-Cette approche permet une gestion automatisée des actions concrètes et des interactions utilisateur simulées, ce qui la rend adaptée aux scénarios d'évaluation où vous souhaitez tester la capacité de l'agent à effectuer des tâches avec une intervention humaine minimale.
-
-### Exemple d'implémentation
-
-Voici un exemple de `user_response_fn` utilisée dans l'évaluation SWE-Bench :
-
-```python
-def codeact_user_response(state: State | None) -> str:
-    msg = (
-        'Veuillez continuer à travailler sur la tâche avec l\'approche que vous jugez appropriée.\n'
-        'Si vous pensez avoir résolu la tâche, veuillez d\'abord envoyer votre réponse à l\'utilisateur via un message, puis <execute_bash> exit </execute_bash>.\n'
-        'IMPORTANT : VOUS NE DEVEZ JAMAIS DEMANDER DE L\'AIDE HUMAINE.\n'
-    )
-
-    if state and state.history:
-        # vérifier si l'agent a essayé de parler à l'utilisateur 3 fois, si oui, faire savoir à l'agent qu'il peut abandonner
-        user_msgs = [
-            event
-            for event in state.history
-            if isinstance(event, MessageAction) and event.source == 'user'
-        ]
-        if len(user_msgs) >= 2:
-            # faire savoir à l'agent qu'il peut abandonner lorsqu'il a essayé 3 fois
-            return (
-                msg
-                + 'Si vous voulez abandonner, exécutez : <execute_bash> exit </execute_bash>.\n'
-            )
-    return msg
-```
-
-Cette fonction fait ce qui suit :
-
-1. Fournit un message standard encourageant l'agent à continuer à travailler
-2. Vérifie combien de fois l'agent a tenté de communiquer avec l'utilisateur
-3. Si l'agent a fait plusieurs tentatives, il lui donne la possibilité d'abandonner
-
-En utilisant cette fonction, vous pouvez garantir un comportement cohérent sur plusieurs exécutions d'évaluation et empêcher l'agent de rester bloqué en attendant une entrée humaine.

docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/github-action.md

@@ -14,4 +14,4 @@ Pour utiliser l'Action GitHub OpenHands dans le dépôt OpenHands, un mainteneur
 
 ## Installation de l'Action dans un nouveau dépôt
 
-Pour installer l'Action GitHub OpenHands dans votre propre dépôt, suivez les [instructions dans le dépôt OpenHands Resolver](https://github.com/All-Hands-AI/OpenHands/blob/main/openhands/resolver/README.md).
+Pour installer l'Action GitHub OpenHands dans votre propre dépôt, suivez les [instructions dans le dépôt OpenHands Resolver](https://github.com/All-Hands-AI/OpenHands-resolver?tab=readme-ov-file#using-the-github-actions-workflow).

docs/i18n/fr/docusaurus-plugin-content-docs/current/usage/how-to/headless-mode.md

@@ -1,5 +1,3 @@
-
-
 # Mode sans interface
 
 Vous pouvez exécuter OpenHands avec une seule commande, sans démarrer l'application web.
@@ -13,46 +11,4 @@ Pour exécuter OpenHands en mode sans interface avec Python,
 [suivez les instructions de configuration de développement](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md),
 puis exécutez :
 
-```bash
-poetry run python -m openhands.core.main -t "write a bash script that prints hi"
-```
 
-Vous devrez vous assurer de définir votre modèle, votre clé API et d'autres paramètres via des variables d'environnement
-[ou le fichier `config.toml`](https://github.com/All-Hands-AI/OpenHands/blob/main/config.template.toml).
-
-## Avec Docker
-
-1. Définissez `WORKSPACE_BASE` sur le répertoire que vous voulez qu'OpenHands modifie :
-
-```bash
-WORKSPACE_BASE=$(pwd)/workspace
-```
-
-2. Définissez `LLM_MODEL` sur le modèle que vous voulez utiliser :
-
-```bash
-LLM_MODEL="anthropic/claude-3-5-sonnet-20241022"
-```
-
-3. Définissez `LLM_API_KEY` sur votre clé API :
-
-```bash
-LLM_API_KEY="sk_test_12345"
-```
-
-4. Exécutez la commande Docker suivante :
-
-```bash
-docker run -it \
-    --pull=always \
-    -e SANDBOX_USER_ID=$(id -u) \
-    -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
-    -e LLM_API_KEY=$LLM_API_KEY \
-    -e LLM_MODEL=$LLM_MODEL \
-    -v $WORKSPACE_BASE:/opt/workspace_base \
-    -v /var/run/docker.sock:/var/run/docker.sock \
-    --add-host host.docker.internal:host-gateway \
-    --name openhands-app-$(date +%Y%m%d%H%M%S) \
-    ghcr.io/all-hands-ai/openhands:0.11 \
-    python -m openhands.core.main -t "write a bash script that prints hi"
-```

docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/cli-mode.md

@@ -14,96 +14,4 @@ OpenHands 可以在交互式命令行模式下运行,允许用户通过命令行
 
 2. 运行以下命令:
 
-```bash
-poetry run python -m openhands.core.cli
-```
 
-该命令将启动一个交互式会话,你可以在其中输入任务并接收来自 OpenHands 的响应。
-
-你需要确保通过环境变量[或 `config.toml` 文件](https://github.com/All-Hands-AI/OpenHands/blob/main/config.template.toml)设置你的模型、API 密钥和其他设置。
-
-
-## 使用 Docker
-
-要在 Docker 中以命令行模式运行 OpenHands,请按照以下步骤操作:
-
-1. 将 `WORKSPACE_BASE` 设置为你希望 OpenHands 编辑的目录:
-
-```bash
-WORKSPACE_BASE=$(pwd)/workspace
-```
-
-2. 将 `LLM_MODEL` 设置为你要使用的模型:
-
-```bash
-LLM_MODEL="anthropic/claude-3-5-sonnet-20241022"
-```
-
-3. 将 `LLM_API_KEY` 设置为你的 API 密钥:
-
-```bash
-LLM_API_KEY="sk_test_12345"
-```
-
-4. 运行以下 Docker 命令:
-
-```bash
-docker run -it \
-    --pull=always \
-    -e SANDBOX_USER_ID=$(id -u) \
-    -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
-    -e LLM_API_KEY=$LLM_API_KEY \
-    -e LLM_MODEL=$LLM_MODEL \
-    -v $WORKSPACE_BASE:/opt/workspace_base \
-    -v /var/run/docker.sock:/var/run/docker.sock \
-    --add-host host.docker.internal:host-gateway \
-    --name openhands-app-$(date +%Y%m%d%H%M%S) \
-    ghcr.io/all-hands-ai/openhands:0.11 \
-    python -m openhands.core.cli
-```
-
-该命令将在 Docker 中启动一个交互式会话,你可以在其中输入任务并接收来自 OpenHands 的响应。
-
-## 命令行命令和预期输出示例
-
-以下是一些命令行命令及其预期输出的示例:
-
-### 示例 1: 简单任务
-
-```bash
-How can I help? >> Write a Python script that prints "Hello, World!"
-```
-
-预期输出:
-
-```bash
-🤖 Sure! Here is a Python script that prints "Hello, World!":
-
-❯ print("Hello, World!")
-```
-
-### 示例 2: Bash 命令
-
-```bash
-How can I help? >> Create a directory named "test_dir"
-```
-
-预期输出:
-
-```bash
-🤖 Creating a directory named "test_dir":
-
-❯ mkdir test_dir
-```
-
-### 示例 3: 错误处理
-
-```bash
-How can I help? >> Delete a non-existent file
-```
-
-预期输出:
-
-```bash
-🤖 An error occurred. Please try again.
-```

docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/evaluation-harness.md

@@ -9,270 +9,4 @@
 
 以下是一个示例配置文件，您可以使用它来定义和使用多个 LLM：
 
-```toml
-[llm]
-# 重要：在此处添加您的 API 密钥，并将模型设置为您要评估的模型
-model = "claude-3-5-sonnet-20241022"
-api_key = "sk-XXX"
 
-[llm.eval_gpt4_1106_preview_llm]
-model = "gpt-4-1106-preview"
-api_key = "XXX"
-temperature = 0.0
-
-[llm.eval_some_openai_compatible_model_llm]
-model = "openai/MODEL_NAME"
-base_url = "https://OPENAI_COMPATIBLE_URL/v1"
-api_key = "XXX"
-temperature = 0.0
-```
-
-
-## 如何在命令行中使用 OpenHands
-
-可以使用以下格式从命令行运行 OpenHands：
-
-```bash
-poetry run python ./openhands/core/main.py \
-        -i <max_iterations> \
-        -t "<task_description>" \
-        -c <agent_class> \
-        -l <llm_config>
-```
-
-例如：
-
-```bash
-poetry run python ./openhands/core/main.py \
-        -i 10 \
-        -t "Write me a bash script that prints hello world." \
-        -c CodeActAgent \
-        -l llm
-```
-
-此命令使用以下参数运行 OpenHands：
-- 最大迭代次数为 10
-- 指定的任务描述
-- 使用 CodeActAgent
-- 使用 `config.toml` 文件的 `llm` 部分中定义的 LLM 配置
-
-## OpenHands 如何工作
-
-OpenHands 的主要入口点在 `openhands/core/main.py` 中。以下是它工作原理的简化流程：
-
-1. 解析命令行参数并加载配置
-2. 使用 `create_runtime()` 创建运行时环境
-3. 初始化指定的代理
-4. 使用 `run_controller()` 运行控制器，它：
-   - 将运行时附加到代理
-   - 执行代理的任务
-   - 完成后返回最终状态
-
-`run_controller()` 函数是 OpenHands 执行的核心。它管理代理、运行时和任务之间的交互，处理用户输入模拟和事件处理等事项。
-
-
-## 入门最简单的方法：探索现有基准
-
-我们鼓励您查看我们仓库的 [`evaluation/` 目录](https://github.com/All-Hands-AI/OpenHands/blob/main/evaluation)中提供的各种评估基准。
-
-要集成您自己的基准，我们建议从最接近您需求的基准开始。这种方法可以显著简化您的集成过程，允许您在现有结构的基础上进行构建并使其适应您的特定要求。
-
-## 如何创建评估工作流
-
-
-要为您的基准创建评估工作流，请按照以下步骤操作：
-
-1. 导入相关的 OpenHands 实用程序：
-   ```python
-    import openhands.agenthub
-    from evaluation.utils.shared import (
-        EvalMetadata,
-        EvalOutput,
-        make_metadata,
-        prepare_dataset,
-        reset_logger_for_multiprocessing,
-        run_evaluation,
-    )
-    from openhands.controller.state.state import State
-    from openhands.core.config import (
-        AppConfig,
-        SandboxConfig,
-        get_llm_config_arg,
-        parse_arguments,
-    )
-    from openhands.core.logger import openhands_logger as logger
-    from openhands.core.main import create_runtime, run_controller
-    from openhands.events.action import CmdRunAction
-    from openhands.events.observation import CmdOutputObservation, ErrorObservation
-    from openhands.runtime.runtime import Runtime
-   ```
-
-2. 创建配置：
-   ```python
-   def get_config(instance: pd.Series, metadata: EvalMetadata) -> AppConfig:
-       config = AppConfig(
-           default_agent=metadata.agent_class,
-           runtime='eventstream',
-           max_iterations=metadata.max_iterations,
-           sandbox=SandboxConfig(
-               base_container_image='your_container_image',
-               enable_auto_lint=True,
-               timeout=300,
-           ),
-       )
-       config.set_llm_config(metadata.llm_config)
-       return config
-   ```
-
-3. 初始化运行时并设置评估环境：
-   ```python
-   def initialize_runtime(runtime: Runtime, instance: pd.Series):
-       # 在此处设置您的评估环境
-       # 例如，设置环境变量、准备文件等
-       pass
-   ```
-
-4. 创建一个函数来处理每个实例：
-   ```python
-   from openhands.utils.async_utils import call_async_from_sync
-   def process_instance(instance: pd.Series, metadata: EvalMetadata) -> EvalOutput:
-       config = get_config(instance, metadata)
-       runtime = create_runtime(config)
-       call_async_from_sync(runtime.connect)
-       initialize_runtime(runtime, instance)
-
-       instruction = get_instruction(instance, metadata)
-
-       state = run_controller(
-           config=config,
-           task_str=instruction,
-           runtime=runtime,
-           fake_user_response_fn=your_user_response_function,
-       )
-
-       # 评估代理的操作
-       evaluation_result = await evaluate_agent_actions(runtime, instance)
-
-       return EvalOutput(
-           instance_id=instance.instance_id,
-           instruction=instruction,
-           test_result=evaluation_result,
-           metadata=metadata,
-           history=compatibility_for_eval_history_pairs(state.history),
-           metrics=state.metrics.get() if state.metrics else None,
-           error=state.last_error if state and state.last_error else None,
-       )
-   ```
-
-5. 运行评估：
-   ```python
-   metadata = make_metadata(llm_config, dataset_name, agent_class, max_iterations, eval_note, eval_output_dir)
-   output_file = os.path.join(metadata.eval_output_dir, 'output.jsonl')
-   instances = prepare_dataset(your_dataset, output_file, eval_n_limit)
-
-   await run_evaluation(
-       instances,
-       metadata,
-       output_file,
-       num_workers,
-       process_instance
-   )
-   ```
-
-此工作流设置配置，初始化运行时环境，通过运行代理并评估其操作来处理每个实例，然后将结果收集到 `EvalOutput` 对象中。`run_evaluation` 函数处理并行化和进度跟踪。
-
-请记住根据您特定的基准要求自定义 `get_instruction`、`your_user_response_function` 和 `evaluate_agent_actions` 函数。
-
-通过遵循此结构，您可以在 OpenHands 框架内为您的基准创建强大的评估工作流。
-
-
-## 理解 `user_response_fn`
-
-`user_response_fn` 是 OpenHands 评估工作流中的关键组件。它模拟用户与代理的交互，允许在评估过程中自动响应。当您想要为代理的查询或操作提供一致的、预定义的响应时，此函数特别有用。
-
-
-### 工作流和交互
-
-处理操作和 `user_response_fn` 的正确工作流如下：
-
-1. 代理接收任务并开始处理
-2. 代理发出操作
-3. 如果操作可执行（例如 CmdRunAction、IPythonRunCellAction）：
-   - 运行时处理操作
-   - 运行时返回观察结果
-4. 如果操作不可执行（通常是 MessageAction）：
-   - 调用 `user_response_fn`
-   - 它返回模拟的用户响应
-5. 代理接收观察结果或模拟响应
-6. 重复步骤 2-5，直到任务完成或达到最大迭代次数
-
-以下是更准确的可视化表示：
-
-```
-                 [代理]
-                    |
-                    v
-               [发出操作]
-                    |
-                    v
-            [操作是否可执行？]
-           /                       \
-         是                         否
-          |                          |
-          v                          v
-     [运行时]                 [user_response_fn]
-          |                          |
-          v                          v
-  [返回观察结果]           [模拟响应]
-           \                        /
-            \                      /
-             v                    v
-           [代理接收反馈]
-                    |
-                    v
-         [继续或完成任务]
-```
-
-在此工作流中：
-
-- 可执行的操作（如运行命令或执行代码）由运行时直接处理
-- 不可执行的操作（通常是当代理想要通信或寻求澄清时）由 `user_response_fn` 处理
-- 然后，代理处理反馈，无论是来自运行时的观察结果还是来自 `user_response_fn` 的模拟响应
-
-这种方法允许自动处理具体操作和模拟用户交互，使其适用于您想要测试代理在最少人工干预的情况下完成任务的能力的评估场景。
-
-### 示例实现
-
-以下是 SWE-Bench 评估中使用的 `user_response_fn` 示例：
-
-```python
-def codeact_user_response(state: State | None) -> str:
-    msg = (
-        'Please continue working on the task on whatever approach you think is suitable.\n'
-        'If you think you have solved the task, please first send your answer to user through message and then <execute_bash> exit </execute_bash>.\n'
-        'IMPORTANT: YOU SHOULD NEVER ASK FOR HUMAN HELP.\n'
-    )
-
-    if state and state.history:
-        # 检查代理是否已尝试与用户对话 3 次，如果是，让代理知道它可以放弃
-        user_msgs = [
-            event
-            for event in state.history
-            if isinstance(event, MessageAction) and event.source == 'user'
-        ]
-        if len(user_msgs) >= 2:
-            # 让代理知道它在尝试 3 次后可以放弃
-            return (
-                msg
-                + 'If you want to give up, run: <execute_bash> exit </execute_bash>.\n'
-            )
-    return msg
-```
-
-此函数执行以下操作：
-
-1. 提供一条标准消息，鼓励代理继续工作
-2. 检查代理尝试与用户通信的次数
-3. 如果代理已多次尝试，它会提供放弃的选项
-
-通过使用此函数，您可以确保在多次评估运行中保持一致的行为，并防止代理在等待人工输入时陷入困境。

docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/github-action.md

@@ -12,4 +12,4 @@
 
 ## 在新仓库中安装 Action
 
-要在你自己的仓库中安装 OpenHands GitHub Action，请按照 [OpenHands Resolver 仓库中的说明](https://github.com/All-Hands-AI/OpenHands/blob/main/openhands/resolver/README.md) 进行操作。
+要在你自己的仓库中安装 OpenHands GitHub Action，请按照 [OpenHands Resolver 仓库中的说明](https://github.com/All-Hands-AI/OpenHands-resolver?tab=readme-ov-file#using-the-github-actions-workflow) 进行操作。

docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/usage/how-to/headless-mode.md

@@ -13,48 +13,4 @@
 [请按照开发设置说明](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md),
 然后运行:
 
-```bash
-poetry run python -m openhands.core.main -t "write a bash script that prints hi"
-```
 
-你需要确保通过环境变量
-[或 `config.toml` 文件](https://github.com/All-Hands-AI/OpenHands/blob/main/config.template.toml)
-设置你的模型、API 密钥和其他设置。
-
-## 使用 Docker
-
-1. 将 `WORKSPACE_BASE` 设置为你希望 OpenHands 编辑的目录:
-
-```bash
-WORKSPACE_BASE=$(pwd)/workspace
-```
-
-2. 将 `LLM_MODEL` 设置为你要使用的模型:
-
-```bash
-LLM_MODEL="anthropic/claude-3-5-sonnet-20241022"
-
-```
-
-3. 将 `LLM_API_KEY` 设置为你的 API 密钥:
-
-```bash
-LLM_API_KEY="sk_test_12345"
-```
-
-4. 运行以下 Docker 命令:
-
-```bash
-docker run -it \
-    --pull=always \
-    -e SANDBOX_USER_ID=$(id -u) \
-    -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
-    -e LLM_API_KEY=$LLM_API_KEY \
-    -e LLM_MODEL=$LLM_MODEL \
-    -v $WORKSPACE_BASE:/opt/workspace_base \
-    -v /var/run/docker.sock:/var/run/docker.sock \
-    --add-host host.docker.internal:host-gateway \
-    --name openhands-app-$(date +%Y%m%d%H%M%S) \
-    ghcr.io/all-hands-ai/openhands:0.11 \
-    python -m openhands.core.main -t "write a bash script that prints hi"
-```

docs/modules/usage/about.md

@@ -1,6 +1,6 @@
-# About OpenHands
+# 📚 Misc
 
-## Research Strategy
+## ⭐️ Research Strategy
 
 Achieving full replication of production-grade applications with LLMs is a complex endeavor. Our strategy involves:
 
@@ -9,11 +9,34 @@ Achieving full replication of production-grade applications with LLMs is a compl
 3. **Task Planning:** Developing capabilities for bug detection, codebase management, and optimization
 4. **Evaluation:** Establishing comprehensive evaluation metrics to better understand and improve our models
 
-## Default Agent
+## 🚧 Default Agent
 
 Our default Agent is currently the [CodeActAgent](agents), which is capable of generating code and handling files.
 
-## Built With
+## 🤝 How to Contribute
+
+OpenHands is a community-driven project, and we welcome contributions from everyone. Whether you're a developer, a researcher, or simply enthusiastic about advancing the field of software engineering with AI, there are many ways to get involved:
+
+- **Code Contributions:** Help us develop the core functionalities, frontend interface, or sandboxing solutions
+- **Research and Evaluation:** Contribute to our understanding of LLMs in software engineering, participate in evaluating the models, or suggest improvements
+- **Feedback and Testing:** Use the OpenHands toolset, report bugs, suggest features, or provide feedback on usability
+
+For details, please check [this document](https://github.com/All-Hands-AI/OpenHands/blob/main/CONTRIBUTING.md).
+
+## 🤖 Join Our Community
+
+We have both Slack workspace for the collaboration on building OpenHands and Discord server for discussion about anything related, e.g., this project, LLM, agent, etc.
+
+- [Slack workspace](https://join.slack.com/t/opendevin/shared_invite/zt-2oikve2hu-UDxHeo8nsE69y6T7yFX_BA)
+- [Discord server](https://discord.gg/ESHStjSjD4)
+
+If you would love to contribute, feel free to join our community. Let's simplify software engineering together!
+
+🐚 **Code less, make more with OpenHands.**
+
+[![Star History Chart](https://api.star-history.com/svg?repos=All-Hands-AI/OpenHands&type=Date)](https://star-history.com/#All-Hands-AI/OpenHands&Date)
+
+## 🛠️ Built With
 
 OpenHands is built using a combination of powerful frameworks and libraries, providing a robust foundation for its development. Here are the key technologies used in the project:
 
@@ -21,6 +44,6 @@ OpenHands is built using a combination of powerful frameworks and libraries, pro
 
 Please note that the selection of these technologies is in progress, and additional technologies may be added or existing ones may be removed as the project evolves. We strive to adopt the most suitable and efficient tools to enhance the capabilities of OpenHands.
 
-## License
+## 📜 License
 
-Distributed under MIT [License](https://github.com/All-Hands-AI/OpenHands/blob/main/LICENSE).
+Distributed under the MIT License. See [our license](https://github.com/All-Hands-AI/OpenHands/blob/main/LICENSE) for more information.

docs/modules/usage/how-to/cli-mode.md

@@ -50,7 +50,6 @@ LLM_API_KEY="sk_test_12345"
 ```bash
 docker run -it \
     --pull=always \
-    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.14-nikolaik \
     -e SANDBOX_USER_ID=$(id -u) \
     -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
     -e LLM_API_KEY=$LLM_API_KEY \
@@ -59,7 +58,7 @@ docker run -it \
     -v /var/run/docker.sock:/var/run/docker.sock \
     --add-host host.docker.internal:host-gateway \
     --name openhands-app-$(date +%Y%m%d%H%M%S) \
-    docker.all-hands.dev/all-hands-ai/openhands:0.14 \
+    ghcr.io/all-hands-ai/openhands:0.11 \
     python -m openhands.core.cli
 ```
 
@@ -108,3 +107,4 @@ Expected Output:
 ```bash
 🤖 An error occurred. Please try again.
 ```
+

docs/modules/usage/how-to/custom-sandbox-guide.md

@@ -62,3 +62,25 @@ Run OpenHands by running ```make run``` in the top level directory.
 ## Technical Explanation
 
 Please refer to [custom docker image section of the runtime documentation](https://docs.all-hands.dev/modules/usage/architecture/runtime#advanced-how-openhands-builds-and-maintains-od-runtime-images) for more details.
+
+## Troubleshooting / Errors
+
+### Error: ```useradd: UID 1000 is not unique```
+
+If you see this error in the console output it is because OpenHands is trying to create the openhands user in the sandbox with a UID of 1000, however this UID is already being used in the image (for some reason). To fix this change the sandbox_user_id field in the config.toml file to a different value:
+
+```toml
+[core]
+workspace_base="./workspace"
+run_as_openhands=true
+sandbox_base_container_image="custom_image"
+sandbox_user_id="1001"
+```
+
+### Port use errors
+
+If you see an error about a port being in use or unavailable, try deleting all running Docker Containers (run `docker ps` and `docker rm` relevant containers) and then re-running ```make run``` .
+
+## Discuss
+
+For other issues or questions join the [Slack](https://join.slack.com/t/opendevin/shared_invite/zt-2oikve2hu-UDxHeo8nsE69y6T7yFX_BA) or [Discord](https://discord.gg/ESHStjSjD4) and ask!

docs/modules/usage/how-to/evaluation-harness.md

@@ -9,270 +9,4 @@ OpenHands in development mode uses `config.toml` to keep track of most configura
 
 Here's an example configuration file you can use to define and use multiple LLMs:
 
-```toml
-[llm]
-# IMPORTANT: add your API key here, and set the model to the one you want to evaluate
-model = "claude-3-5-sonnet-20241022"
-api_key = "sk-XXX"
 
-[llm.eval_gpt4_1106_preview_llm]
-model = "gpt-4-1106-preview"
-api_key = "XXX"
-temperature = 0.0
-
-[llm.eval_some_openai_compatible_model_llm]
-model = "openai/MODEL_NAME"
-base_url = "https://OPENAI_COMPATIBLE_URL/v1"
-api_key = "XXX"
-temperature = 0.0
-```
-
-
-## How to use OpenHands in the command line
-
-OpenHands can be run from the command line using the following format:
-
-```bash
-poetry run python ./openhands/core/main.py \
-        -i <max_iterations> \
-        -t "<task_description>" \
-        -c <agent_class> \
-        -l <llm_config>
-```
-
-For example:
-
-```bash
-poetry run python ./openhands/core/main.py \
-        -i 10 \
-        -t "Write me a bash script that prints hello world." \
-        -c CodeActAgent \
-        -l llm
-```
-
-This command runs OpenHands with:
-- A maximum of 10 iterations
-- The specified task description
-- Using the CodeActAgent
-- With the LLM configuration defined in the `llm` section of your `config.toml` file
-
-## How does OpenHands work
-
-The main entry point for OpenHands is in `openhands/core/main.py`. Here's a simplified flow of how it works:
-
-1. Parse command-line arguments and load the configuration
-2. Create a runtime environment using `create_runtime()`
-3. Initialize the specified agent
-4. Run the controller using `run_controller()`, which:
-   - Attaches the runtime to the agent
-   - Executes the agent's task
-   - Returns a final state when complete
-
-The `run_controller()` function is the core of OpenHands's execution. It manages the interaction between the agent, the runtime, and the task, handling things like user input simulation and event processing.
-
-
-## Easiest way to get started: Exploring Existing Benchmarks
-
-We encourage you to review the various evaluation benchmarks available in the [`evaluation/` directory](https://github.com/All-Hands-AI/OpenHands/blob/main/evaluation) of our repository.
-
-To integrate your own benchmark, we suggest starting with the one that most closely resembles your needs. This approach can significantly streamline your integration process, allowing you to build upon existing structures and adapt them to your specific requirements.
-
-## How to create an evaluation workflow
-
-
-To create an evaluation workflow for your benchmark, follow these steps:
-
-1. Import relevant OpenHands utilities:
-   ```python
-    import openhands.agenthub
-    from evaluation.utils.shared import (
-        EvalMetadata,
-        EvalOutput,
-        make_metadata,
-        prepare_dataset,
-        reset_logger_for_multiprocessing,
-        run_evaluation,
-    )
-    from openhands.controller.state.state import State
-    from openhands.core.config import (
-        AppConfig,
-        SandboxConfig,
-        get_llm_config_arg,
-        parse_arguments,
-    )
-    from openhands.core.logger import openhands_logger as logger
-    from openhands.core.main import create_runtime, run_controller
-    from openhands.events.action import CmdRunAction
-    from openhands.events.observation import CmdOutputObservation, ErrorObservation
-    from openhands.runtime.runtime import Runtime
-   ```
-
-2. Create a configuration:
-   ```python
-   def get_config(instance: pd.Series, metadata: EvalMetadata) -> AppConfig:
-       config = AppConfig(
-           default_agent=metadata.agent_class,
-           runtime='eventstream',
-           max_iterations=metadata.max_iterations,
-           sandbox=SandboxConfig(
-               base_container_image='your_container_image',
-               enable_auto_lint=True,
-               timeout=300,
-           ),
-       )
-       config.set_llm_config(metadata.llm_config)
-       return config
-   ```
-
-3. Initialize the runtime and set up the evaluation environment:
-   ```python
-   def initialize_runtime(runtime: Runtime, instance: pd.Series):
-       # Set up your evaluation environment here
-       # For example, setting environment variables, preparing files, etc.
-       pass
-   ```
-
-4. Create a function to process each instance:
-   ```python
-   from openhands.utils.async_utils import call_async_from_sync
-   def process_instance(instance: pd.Series, metadata: EvalMetadata) -> EvalOutput:
-       config = get_config(instance, metadata)
-       runtime = create_runtime(config)
-       call_async_from_sync(runtime.connect)
-       initialize_runtime(runtime, instance)
-
-       instruction = get_instruction(instance, metadata)
-
-       state = run_controller(
-           config=config,
-           task_str=instruction,
-           runtime=runtime,
-           fake_user_response_fn=your_user_response_function,
-       )
-
-       # Evaluate the agent's actions
-       evaluation_result = await evaluate_agent_actions(runtime, instance)
-
-       return EvalOutput(
-           instance_id=instance.instance_id,
-           instruction=instruction,
-           test_result=evaluation_result,
-           metadata=metadata,
-           history=compatibility_for_eval_history_pairs(state.history),
-           metrics=state.metrics.get() if state.metrics else None,
-           error=state.last_error if state and state.last_error else None,
-       )
-   ```
-
-5. Run the evaluation:
-   ```python
-   metadata = make_metadata(llm_config, dataset_name, agent_class, max_iterations, eval_note, eval_output_dir)
-   output_file = os.path.join(metadata.eval_output_dir, 'output.jsonl')
-   instances = prepare_dataset(your_dataset, output_file, eval_n_limit)
-
-   await run_evaluation(
-       instances,
-       metadata,
-       output_file,
-       num_workers,
-       process_instance
-   )
-   ```
-
-This workflow sets up the configuration, initializes the runtime environment, processes each instance by running the agent and evaluating its actions, and then collects the results into an `EvalOutput` object. The `run_evaluation` function handles parallelization and progress tracking.
-
-Remember to customize the `get_instruction`, `your_user_response_function`, and `evaluate_agent_actions` functions according to your specific benchmark requirements.
-
-By following this structure, you can create a robust evaluation workflow for your benchmark within the OpenHands framework.
-
-
-## Understanding the `user_response_fn`
-
-The `user_response_fn` is a crucial component in OpenHands's evaluation workflow. It simulates user interaction with the agent, allowing for automated responses during the evaluation process. This function is particularly useful when you want to provide consistent, predefined responses to the agent's queries or actions.
-
-
-### Workflow and Interaction
-
-The correct workflow for handling actions and the `user_response_fn` is as follows:
-
-1. Agent receives a task and starts processing
-2. Agent emits an Action
-3. If the Action is executable (e.g., CmdRunAction, IPythonRunCellAction):
-   - The Runtime processes the Action
-   - Runtime returns an Observation
-4. If the Action is not executable (typically a MessageAction):
-   - The `user_response_fn` is called
-   - It returns a simulated user response
-5. The agent receives either the Observation or the simulated response
-6. Steps 2-5 repeat until the task is completed or max iterations are reached
-
-Here's a more accurate visual representation:
-
-```
-                 [Agent]
-                    |
-                    v
-               [Emit Action]
-                    |
-                    v
-            [Is Action Executable?]
-           /                       \
-         Yes                        No
-          |                          |
-          v                          v
-     [Runtime]               [user_response_fn]
-          |                          |
-          v                          v
-  [Return Observation]    [Simulated Response]
-           \                        /
-            \                      /
-             v                    v
-           [Agent receives feedback]
-                    |
-                    v
-         [Continue or Complete Task]
-```
-
-In this workflow:
-
-- Executable actions (like running commands or executing code) are handled directly by the Runtime
-- Non-executable actions (typically when the agent wants to communicate or ask for clarification) are handled by the `user_response_fn`
-- The agent then processes the feedback, whether it's an Observation from the Runtime or a simulated response from the `user_response_fn`
-
-This approach allows for automated handling of both concrete actions and simulated user interactions, making it suitable for evaluation scenarios where you want to test the agent's ability to complete tasks with minimal human intervention.
-
-### Example Implementation
-
-Here's an example of a `user_response_fn` used in the SWE-Bench evaluation:
-
-```python
-def codeact_user_response(state: State | None) -> str:
-    msg = (
-        'Please continue working on the task on whatever approach you think is suitable.\n'
-        'If you think you have solved the task, please first send your answer to user through message and then <execute_bash> exit </execute_bash>.\n'
-        'IMPORTANT: YOU SHOULD NEVER ASK FOR HUMAN HELP.\n'
-    )
-
-    if state and state.history:
-        # check if the agent has tried to talk to the user 3 times, if so, let the agent know it can give up
-        user_msgs = [
-            event
-            for event in state.history
-            if isinstance(event, MessageAction) and event.source == 'user'
-        ]
-        if len(user_msgs) >= 2:
-            # let the agent know that it can give up when it has tried 3 times
-            return (
-                msg
-                + 'If you want to give up, run: <execute_bash> exit </execute_bash>.\n'
-            )
-    return msg
-```
-
-This function does the following:
-
-1. Provides a standard message encouraging the agent to continue working
-2. Checks how many times the agent has attempted to communicate with the user
-3. If the agent has made multiple attempts, it provides an option to give up
-
-By using this function, you can ensure consistent behavior across multiple evaluation runs and prevent the agent from getting stuck waiting for human input.

docs/modules/usage/how-to/github-action.md

@@ -4,92 +4,12 @@ This guide explains how to use the OpenHands GitHub Action, both within the Open
 
 ## Using the Action in the OpenHands Repository
 
-To use the OpenHands GitHub Action in a repository, you can:
+To use the OpenHands GitHub Action in the OpenHands repository, an OpenHands maintainer can:
 
 1. Create an issue in the repository.
-2. Add the `fix-me` label to the issue or leave a comment on the issue starting with `@openhands-agent`.
-
-The action will automatically trigger and attempt to resolve the issue.
+2. Add the `fix-me` label to the issue.
+3. The action will automatically trigger and attempt to resolve the issue.
 
 ## Installing the Action in a New Repository
 
-To install the OpenHands GitHub Action in your own repository, follow
-the [README for the OpenHands Resolver](https://github.com/All-Hands-AI/OpenHands/blob/main/openhands/resolver/README.md).
-
-## Usage Tips
-
-### Iterative resolution
-
-1. Create an issue in the repository.
-2. Add the `fix-me` label to the issue, or leave a comment starting with `@openhands-agent`
-3. Review the attempt to resolve the issue by checking the pull request
-4. Follow up with feedback through general comments, review comments, or inline thread comments
-5. Add the `fix-me` label to the pull request, or address a specific comment by starting with `@openhands-agent`
-
-### Label versus Macro
-
-- Label (`fix-me`): Requests OpenHands to address the **entire** issue or pull request.
-- Macro (`@openhands-agent`): Requests OpenHands to consider only the issue/pull request description and **the specific comment**.
-
-## Advanced Settings
-
-### Add custom repository settings
-
-You can provide custom directions for OpenHands by following the [README for the resolver](https://github.com/All-Hands-AI/OpenHands/blob/main/openhands/resolver/README.md#providing-custom-instructions).
-
-### Configure custom macro
-
-To customize the default macro (`@openhands-agent`):
-
-1. [Create a repository variable](https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/store-information-in-variables#creating-configuration-variables-for-a-repository) named `OPENHANDS_MACRO`
-2. Assign the variable a custom value
-
-## Writing Effective .openhands_instructions Files
-
-The `.openhands_instructions` file is a file that you can put in the root directory of your repository to guide OpenHands in understanding and working with your repository effectively. Here are key tips for writing high-quality instructions:
-
-### Core Principles
-
-1. **Concise but Informative**: Provide a clear, focused overview of the repository that emphasizes the most common actions OpenHands will need to perform.
-
-2. **Repository Structure**: Explain the key directories and their purposes, especially highlighting where different types of code (e.g., frontend, backend) are located.
-
-3. **Development Workflows**: Document the essential commands for:
-   - Building and setting up the project
-   - Running tests
-   - Linting and code quality checks
-   - Any environment-specific requirements
-
-4. **Testing Guidelines**: Specify:
-   - Where tests are located
-   - How to run specific test suites
-   - Any testing conventions or requirements
-
-### Example Structure
-
-```markdown
-# Repository Overview
-[Brief description of the project]
-
-## General Setup
-- Main build command
-- Development environment setup
-- Pre-commit checks
-
-## Backend
-- Location and structure
-- Testing instructions
-- Environment requirements
-
-## Frontend
-- Setup prerequisites
-- Build and test commands
-- Environment variables
-
-## Additional Guidelines
-- Code style requirements
-- Special considerations
-- Common workflows
-```
-
-For a real-world example, refer to the [OpenHands repository's .openhands_instructions](https://github.com/All-Hands-AI/OpenHands/blob/main/.openhands_instructions).
+To install the OpenHands GitHub Action in your own repository, follow the [directions in the OpenHands Resolver repo](https://github.com/All-Hands-AI/OpenHands-resolver?tab=readme-ov-file#using-the-github-actions-workflow).

docs/modules/usage/how-to/gui-mode.md

@@ -19,15 +19,6 @@ OpenHands provides a user-friendly Graphical User Interface (GUI) mode for inter
 3. Enter the corresponding `API Key` for your chosen provider.
 4. Click "Save" to apply the settings.
 
-### GitHub Token Setup
-
-OpenHands automatically exports a `GITHUB_TOKEN` to the shell environment if it is available. This can happen in two ways:
-
-1. Locally (OSS): The user directly inputs their GitHub token.
-2. Online (SaaS): The token is obtained through GitHub OAuth authentication.
-
-When you reach the `/app` route, the app checks if a token is present. If it finds one, it sets it in the environment for the agent to use.
-
 ### Advanced Settings
 
 1. Toggle `Advanced Options` to access additional settings.

docs/modules/usage/how-to/headless-mode.md

@@ -11,49 +11,4 @@ To run OpenHands in headless mode with Python,
 [follow the Development setup instructions](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md),
 and then run:
 
-```bash
-poetry run python -m openhands.core.main -t "write a bash script that prints hi"
-```
 
-You'll need to be sure to set your model, API key, and other settings via environment variables
-[or the `config.toml` file](https://github.com/All-Hands-AI/OpenHands/blob/main/config.template.toml).
-
-## With Docker
-
-1. Set `WORKSPACE_BASE` to the directory you want OpenHands to edit:
-
-```bash
-WORKSPACE_BASE=$(pwd)/workspace
-```
-
-2. Set `LLM_MODEL` to the model you want to use:
-
-```bash
-LLM_MODEL="anthropic/claude-3-5-sonnet-20241022"
-
-```
-
-3. Set `LLM_API_KEY` to your API key:
-
-```bash
-LLM_API_KEY="sk_test_12345"
-```
-
-4. Run the following Docker command:
-
-```bash
-docker run -it \
-    --pull=always \
-    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.14-nikolaik \
-    -e SANDBOX_USER_ID=$(id -u) \
-    -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
-    -e LLM_API_KEY=$LLM_API_KEY \
-    -e LLM_MODEL=$LLM_MODEL \
-    -e LOG_ALL_EVENTS=true \
-    -v $WORKSPACE_BASE:/opt/workspace_base \
-    -v /var/run/docker.sock:/var/run/docker.sock \
-    --add-host host.docker.internal:host-gateway \
-    --name openhands-app-$(date +%Y%m%d%H%M%S) \
-    docker.all-hands.dev/all-hands-ai/openhands:0.14 \
-    python -m openhands.core.main -t "write a bash script that prints hi"
-```

docs/modules/usage/how-to/openshift-example.md

@@ -150,7 +150,7 @@ metadata:
 spec:
   containers:
   - name: openhands-app-2024
-    image: docker.all-hands.dev/all-hands-ai/openhands:main
+    image: ghcr.io/all-hands-ai/openhands:main
     env:
     - name: SANDBOX_USER_ID
       value: "1000"
@@ -164,7 +164,7 @@ spec:
     ports:
     - containerPort: 3000
   - name: openhands-sandbox-2024
-    image: docker.all-hands.dev/all-hands-ai/runtime:main
+    image: ghcr.io/all-hands-ai/sandbox:main
     ports:
     - containerPort: 51963
     command: ["/usr/sbin/sshd", "-D", "-p 51963", "-o", "PermitRootLogin=yes"]
@@ -205,10 +205,10 @@ LAST SEEN   TYPE     REASON                   OBJECT
 9s          Normal   SuccessfulAttachVolume   pod/openhands-app-2024                AttachVolume.Attach succeeded for volume "pvc-2b1d223a-1c8f-4990-8e3d-68061a9ae252"
 9s          Normal   SuccessfulAttachVolume   pod/openhands-app-2024                AttachVolume.Attach succeeded for volume "pvc-31f15b25-faad-4665-a25f-201a530379af"
 6s          Normal   AddedInterface           pod/openhands-app-2024                Add eth0 [10.128.2.48/23] from openshift-sdn
-6s          Normal   Pulled                   pod/openhands-app-2024                Container image "docker.all-hands.dev/all-hands-ai/openhands:main" already present on machine
+6s          Normal   Pulled                   pod/openhands-app-2024                Container image "ghcr.io/all-hands-ai/openhands:main" already present on machine
 6s          Normal   Created                  pod/openhands-app-2024                Created container openhands-app-2024
 6s          Normal   Started                  pod/openhands-app-2024                Started container openhands-app-2024
-6s          Normal   Pulled                   pod/openhands-app-2024                Container image "docker.all-hands.dev/all-hands-ai/sandbox:main" already present on machine
+6s          Normal   Pulled                   pod/openhands-app-2024                Container image "ghcr.io/all-hands-ai/sandbox:main" already present on machine
 5s          Normal   Created                  pod/openhands-app-2024                Created container openhands-sandbox-2024
 5s          Normal   Started                  pod/openhands-app-2024                Started container openhands-sandbox-2024
 83s         Normal   WaitForFirstConsumer     persistentvolumeclaim/workspace-pvc   waiting for first consumer to be created before binding
@@ -334,7 +334,7 @@ spec:
     spec:
       containers:
       - name: openhands-app-2024
-        image: docker.all-hands.dev/all-hands-ai/openhands:main
+        image: ghcr.io/all-hands-ai/openhands:main
         env:
         - name: SANDBOX_USER_ID
           value: "1000"
@@ -356,7 +356,7 @@ spec:
         ports:
         - containerPort: 3000
       - name: openhands-sandbox-2024
-        image: docker.all-hands.dev/all-hands-ai/runtime:main
+        image: ghcr.io/opendevin/sandbox:main
     #    securityContext:
     #      privileged: true  # Add this to allow privileged access
         ports:

docs/modules/usage/installation.mdx

@@ -8,19 +8,24 @@
 
 ## Start the app
 
-The easiest way to run OpenHands is in Docker.
+The easiest way to run OpenHands is in Docker. You can change `WORKSPACE_BASE` below to point OpenHands to
+existing code that you'd like to modify.
 
 ```bash
-docker pull docker.all-hands.dev/all-hands-ai/runtime:0.14-nikolaik
+export WORKSPACE_BASE=$(pwd)/workspace
 
-docker run -it --rm --pull=always \
-    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.14-nikolaik \
-    -e LOG_ALL_EVENTS=true \
+docker pull ghcr.io/all-hands-ai/runtime:0.11-nikolaik
+
+docker run -it --pull=always \
+    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=ghcr.io/all-hands-ai/runtime:0.11-nikolaik \
+    -e SANDBOX_USER_ID=$(id -u) \
+    -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
+    -v $WORKSPACE_BASE:/opt/workspace_base \
     -v /var/run/docker.sock:/var/run/docker.sock \
     -p 3000:3000 \
     --add-host host.docker.internal:host-gateway \
-    --name openhands-app \
-    docker.all-hands.dev/all-hands-ai/openhands:0.14
+    --name openhands-app-$(date +%Y%m%d%H%M%S) \
+    ghcr.io/all-hands-ai/openhands:0.11
 ```
 
 You can also run OpenHands in a scriptable [headless mode](https://docs.all-hands.dev/modules/usage/how-to/headless-mode), as an [interactive CLI](https://docs.all-hands.dev/modules/usage/how-to/cli-mode), or using the [OpenHands GitHub Action](https://docs.all-hands.dev/modules/usage/how-to/github-action).
@@ -29,6 +34,9 @@ You can also run OpenHands in a scriptable [headless mode](https://docs.all-hand
 
 After running the command above, you'll find OpenHands running at [http://localhost:3000](http://localhost:3000).
 
+The agent will have access to the `./workspace` folder to do its work. You can copy existing code here, or change `WORKSPACE_BASE` in the
+command to point to an existing folder.
+
 Upon launching OpenHands, you'll see a settings modal. You **must** select an `LLM Provider` and `LLM Model` and enter a corresponding `API Key`.
 These can be changed at any time by selecting the `Settings` button (gear icon) in the UI.
 
@@ -44,9 +52,9 @@ The `Advanced Options` also allow you to specify a `Base URL` if required.
 ## Versions
 
 The command above pulls the most recent stable release of OpenHands. You have other options as well:
-- For a specific release, use `docker.all-hands.dev/all-hands-ai/openhands:$VERSION`, replacing $VERSION with the version number.
+- For a specific release, use `ghcr.io/all-hands-ai/openhands:$VERSION`, replacing $VERSION with the version number.
 - We use semver, and release major, minor, and patch tags. So `0.9` will automatically point to the latest `0.9.x` release, and `0` will point to the latest `0.x.x` release.
-- For the most up-to-date development version, you can use `docker.all-hands.dev/all-hands-ai/openhands:main`. This version is unstable and is recommended for testing or development purposes only.
+- For the most up-to-date development version, you can use `ghcr.io/all-hands-ai/openhands:main`. This version is unstable and is recommended for testing or development purposes only.
 
 You can choose the tag that best suits your needs based on stability requirements and desired features.
 

docs/modules/usage/llms/litellm-proxy.md

@@ -1,20 +0,0 @@
-# LiteLLM Proxy
-
-OpenHands supports using the [LiteLLM proxy](https://docs.litellm.ai/docs/proxy/quick_start) to access various LLM providers.
-
-## Configuration
-
-To use LiteLLM proxy with OpenHands, you need to:
-
-1. Set up a LiteLLM proxy server (see [LiteLLM documentation](https://docs.litellm.ai/docs/proxy/quick_start))
-2. When running OpenHands, you'll need to set the following in the OpenHands UI through the Settings:
-  * Enable `Advanced Options`
-  * `Custom Model` to the prefix `litellm_proxy/` + the model you will be using (e.g. `litellm_proxy/anthropic.claude-3-5-sonnet-20241022-v2:0`)
-  * `Base URL` to your LiteLLM proxy URL (e.g. `https://your-litellm-proxy.com`)
-  * `API Key` to your LiteLLM proxy API key
-
-## Supported Models
-
-The supported models depend on your LiteLLM proxy configuration. OpenHands supports any model that your LiteLLM proxy is configured to handle.
-
-Refer to your LiteLLM proxy configuration for the list of available models and their names.

docs/modules/usage/llms/llms.md

@@ -4,11 +4,11 @@ OpenHands can connect to any LLM supported by LiteLLM. However, it requires a po
 
 ## Model Recommendations
 
-Based on our evaluations of language models for coding tasks (using the SWE-bench dataset), we can provide some recommendations for model selection. Some analyses can be found in [this blog article comparing LLMs](https://www.all-hands.dev/blog/evaluation-of-llms-as-coding-agents-on-swe-bench-at-30x-speed) and [this blog article with some more recent results](https://www.all-hands.dev/blog/openhands-codeact-21-an-open-state-of-the-art-software-development-agent).
+Based on a recent evaluation of language models for coding tasks (using the SWE-bench dataset), we can provide some recommendations for model selection. The full analysis can be found in [this blog article](https://www.all-hands.dev/blog/evaluation-of-llms-as-coding-agents-on-swe-bench-at-30x-speed).
 
 When choosing a model, consider both the quality of outputs and the associated costs. Here's a summary of the findings:
 
-- Claude 3.5 Sonnet is the best by a fair amount, achieving a 53% resolve rate on SWE-Bench Verified with the default agent in OpenHands.
+- Claude 3.5 Sonnet is the best by a fair amount, achieving a 27% resolve rate with the default agent in OpenHands.
 - GPT-4o lags behind, and o1-mini actually performed somewhat worse than GPT-4o. We went in and analyzed the results a little, and briefly it seemed like o1 was sometimes "overthinking" things, performing extra environment configuration tasks when it could just go ahead and finish the task.
 - Finally, the strongest open models were Llama 3.1 405 B and deepseek-v2.5, and they performed reasonably, even besting some of the closed models.
 
@@ -63,7 +63,6 @@ We have a few guides for running OpenHands with specific model providers:
 - [Azure](llms/azure-llms)
 - [Google](llms/google-llms)
 - [Groq](llms/groq)
-- [LiteLLM Proxy](llms/litellm-proxy)
 - [OpenAI](llms/openai-llms)
 - [OpenRouter](llms/openrouter)
 

docs/modules/usage/llms/local-llms.md

@@ -35,15 +35,32 @@ Use the instructions [here](../getting-started) to start OpenHands using Docker.
 But when running `docker run`, you'll need to add a few more arguments:
 
 ```bash
-docker run # ...
-    --add-host host.docker.internal:host-gateway \
-    -e LLM_OLLAMA_BASE_URL="http://host.docker.internal:11434" \
-    # ...
+--add-host host.docker.internal:host-gateway \
+-e LLM_OLLAMA_BASE_URL="http://host.docker.internal:11434" \
 ```
 
-LLM_OLLAMA_BASE_URL is optional. If you set it, it will be used to show
-the available installed models in the UI.
+LLM_OLLAMA_BASE_URL is optional. If you set it, it will be used to show the available installed models in the UI.
 
+Example:
+
+```bash
+# The directory you want OpenHands to modify. MUST be an absolute path!
+export WORKSPACE_BASE=$(pwd)/workspace
+
+docker run \
+    -it \
+    --pull=always \
+    --add-host host.docker.internal:host-gateway \
+    -e SANDBOX_USER_ID=$(id -u) \
+    -e LLM_OLLAMA_BASE_URL="http://host.docker.internal:11434" \
+    -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
+    -v $WORKSPACE_BASE:/opt/workspace_base \
+    -v /var/run/docker.sock:/var/run/docker.sock \
+    -p 3000:3000 \
+    ghcr.io/all-hands-ai/openhands:main
+```
+
+You should now be able to connect to `http://localhost:3000/`
 
 ### Configure the Web Application
 
@@ -159,11 +176,18 @@ CUSTOM_LLM_PROVIDER="openai"
 ### Docker
 
 ```bash
-docker run # ...
+docker run \
+    -it \
+    --pull=always \
+    -e SANDBOX_USER_ID=$(id -u) \
     -e LLM_MODEL="openai/lmstudio" \
     -e LLM_BASE_URL="http://host.docker.internal:1234/v1" \
     -e CUSTOM_LLM_PROVIDER="openai" \
-    # ...
+    -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
+    -v $WORKSPACE_BASE:/opt/workspace_base \
+    -v /var/run/docker.sock:/var/run/docker.sock \
+    -p 3000:3000 \
+    ghcr.io/all-hands-ai/openhands:main
 ```
 
 You should now be able to connect to `http://localhost:3000/`

docs/modules/usage/runtimes.md

@@ -1,77 +0,0 @@
-# Runtime Configuration
-
-A Runtime is an environment where the OpenHands agent can edit files and run
-commands.
-
-By default, OpenHands uses a Docker-based runtime, running on your local computer.
-This means you only have to pay for the LLM you're using, and your code is only ever sent to the LLM.
-
-We also support "remote" runtimes, which are typically managed by third-parties.
-They can make setup a bit simpler and more scalable, especially
-if you're running many OpenHands conversations in parallel (e.g. to do evaluation).
-
-## Docker Runtime
-This is the default Runtime that's used when you start OpenHands. You might notice
-some flags being passed to `docker run` that make this possible:
-
-```
-docker run # ...
-    -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.11-nikolaik \
-    -v /var/run/docker.sock:/var/run/docker.sock \
-    # ...
-```
-
-The `SANDBOX_RUNTIME_CONTAINER_IMAGE` from nikolaik is a pre-built runtime image
-that contains our Runtime server, as well as some basic utilities for Python and NodeJS.
-You can also [build your own runtime image](how-to/custom-sandbox-guide).
-
-### Connecting to Your filesystem
-One useful feature here is the ability to connect to your local filesystem.
-
-To mount your filesystem into the runtime, add the following options to
-the `docker run` command:
-
-```bash
-export WORKSPACE_BASE=/path/to/your/code
-
-docker run # ...
-    -e SANDBOX_USER_ID=$(id -u) \
-    -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \
-    -v $WORKSPACE_BASE:/opt/workspace_base \
-    # ...
-```
-
-Be careful! There's nothing stopping the OpenHands agent from deleting or modifying
-any files that are mounted into its workspace.
-
-This setup can cause some issues with file permissions (hence the `SANDBOX_USER_ID` variable)
-but seems to work well on most systems.
-
-## All Hands Runtime
-The All Hands Runtime is currently in beta. You can request access by joining
-the #remote-runtime-limited-beta channel on Slack ([see the README](https://github.com/All-Hands-AI/OpenHands?tab=readme-ov-file#-join-our-community) for an invite).
-
-To use the All Hands Runtime, set the following environment variables when
-starting OpenHands:
-
-```bash
-docker run # ...
-    -e RUNTIME=remote \
-    -e SANDBOX_REMOTE_RUNTIME_API_URL="https://runtime.app.all-hands.dev" \
-    -e SANDBOX_API_KEY="your-all-hands-api-key" \
-    -e SANDBOX_KEEP_RUNTIME_ALIVE="true" \
-    # ...
-```
-
-## Modal Runtime
-Our partners at [Modal](https://modal.com/) have also provided a runtime for OpenHands.
-
-To use the Modal Runtime, create an account, and then [create an API key.](https://modal.com/settings)
-
-You'll then need to set the following environment variables when starting OpenHands:
-```bash
-docker run # ...
-    -e RUNTIME=modal \
-    -e MODAL_API_TOKEN_ID="your-id" \
-    -e MODAL_API_TOKEN_SECRET="your-secret" \
-```

docs/modules/usage/troubleshooting/troubleshooting.md

@@ -16,7 +16,6 @@ Check out [Notes for WSL on Windows Users](troubleshooting/windows) for some tro
 * [404 Resource not found](#404-resource-not-found)
 * [`make build` getting stuck on package installations](#make-build-getting-stuck-on-package-installations)
 * [Sessions are not restored](#sessions-are-not-restored)
-* [Connection to host.docker.internal timed out](#connection-to-host-docker-internal-timed-out)
 
 ### Unable to connect to Docker
 
@@ -154,27 +153,3 @@ should stay accepted.
 ```bash
 EXPORT JWT_SECRET=A_CONST_VALUE
 ```
-
----
-### Connection to host docker internal timed out
-
-**Symptoms**
-
-When you start the server using the docker command from the main [README](https://github.com/All-Hands-AI/OpenHands/README.md), you get a long timeout
-followed by the a stack trace containing messages like:
-
-* `Connection to host.docker.internal timed out. (connect timeout=310)`
-* `Max retries exceeded with url: /alive`
-
-**Details**
-
-If Docker Engine is installed rather than Docker Desktop, the main command will not work as expected.
-Docker Desktop includes easy DNS configuration for connecting processes running in different containers
-which OpenHands makes use of when the main server is running inside a docker container.
-(Further details: https://forums.docker.com/t/difference-between-docker-desktop-and-docker-engine/124612)
-
-**Workarounds**
-
-* [Install Docker Desktop](https://www.docker.com/products/docker-desktop/)
-* Run OpenHands in [Development Mode](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md),
-  So that the main server is not run inside a container, but still creates dockerized runtime sandboxes.

docs/package.json

@@ -15,10 +15,10 @@
     "typecheck": "tsc"
   },
   "dependencies": {
-    "@docusaurus/core": "^3.6.2",
-    "@docusaurus/plugin-content-pages": "^3.6.2",
-    "@docusaurus/preset-classic": "^3.6.2",
-    "@docusaurus/theme-mermaid": "^3.6.2",
+    "@docusaurus/core": "^3.5.2",
+    "@docusaurus/plugin-content-pages": "^3.5.2",
+    "@docusaurus/preset-classic": "^3.5.2",
+    "@docusaurus/theme-mermaid": "^3.5.2",
     "@mdx-js/react": "^3.1.0",
     "clsx": "^2.0.0",
     "prism-react-renderer": "^2.4.0",
@@ -29,7 +29,7 @@
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "^3.5.1",
-    "@docusaurus/tsconfig": "^3.6.2",
+    "@docusaurus/tsconfig": "^3.5.2",
     "@docusaurus/types": "^3.5.1",
     "typescript": "~5.6.3"
   },

docs/sidebars.ts

@@ -76,11 +76,6 @@ const sidebars: SidebarsConfig = {
                   label: 'Groq',
                   id: 'usage/llms/groq',
                 },
-                {
-                  type: 'doc',
-                  label: 'LiteLLM Proxy',
-                  id: 'usage/llms/litellm-proxy',
-                },
                 {
                   type: 'doc',
                   label: 'OpenAI',
@@ -95,11 +90,6 @@ const sidebars: SidebarsConfig = {
             },
           ],
         },
-        {
-          type: 'doc',
-          label: 'Runtime Configuration',
-          id: 'usage/runtimes',
-        },
         {
           type: 'doc',
           label: 'Custom Sandbox',

evaluation/EDA/game.py

@@ -87,7 +87,9 @@ class Q20Game:
         # others
         bingo, anwser_reply = self.judge_winner(response)
         if bingo:
-            return 'You are bingo! Use the "finish" tool to finish the interaction.\n'
+            return (
+                'You are bingo! quit now, run: <execute_bash> exit </execute_bash>.\n'
+            )
         if self.curr_turn == self.num_turns - 2:
             anwser_reply += " You must guess now, what's it?"
         return anwser_reply

evaluation/EDA/run_infer.py

@@ -8,7 +8,6 @@ from evaluation.EDA.game import Q20Game, Q20GameCelebrity
 from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -35,8 +34,7 @@ def codeact_user_response_eda(state: State) -> str:
 
     # retrieve the latest model message from history
     if state.history:
-        last_agent_message = state.get_last_agent_message()
-        model_guess = last_agent_message.content if last_agent_message else ''
+        model_guess = state.history.get_last_agent_message()
 
     assert game is not None, 'Game is not initialized.'
     msg = game.generate_user_response(model_guess)
@@ -141,8 +139,7 @@ def process_instance(
     if state is None:
         raise ValueError('State should not be None.')
 
-    last_agent_message = state.get_last_agent_message()
-    final_message = last_agent_message.content if last_agent_message else ''
+    final_message = state.history.get_last_agent_message()
 
     logger.info(f'Final message: {final_message} | Ground truth: {instance["text"]}')
     test_result = game.reward()
@@ -151,7 +148,7 @@ def process_instance(
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     # Save the output
     output = EvalOutput(

evaluation/README.md

@@ -84,3 +84,4 @@ all the preprocessing/evaluation/analysis scripts.
 - Raw data and experimental records should not be stored within this repo.
 - For model outputs, they should be stored at [this huggingface space](https://huggingface.co/spaces/OpenHands/evaluation) for visualization.
 - Important data files of manageable size and analysis scripts (e.g., jupyter notebooks) can be directly uploaded to this repo.
+

evaluation/agent_bench/run_infer.py

@@ -16,7 +16,6 @@ from evaluation.agent_bench.helper import (
 from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -243,7 +242,7 @@ def process_instance(
         raw_ans = ''
 
         # retrieve the last agent message or thought
-        for event in reversed(state.history):
+        for event in state.history.get_events(reverse=True):
             if event.source == 'agent':
                 if isinstance(event, AgentFinishAction):
                     raw_ans = event.thought
@@ -272,7 +271,7 @@ def process_instance(
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     metrics = state.metrics.get() if state.metrics else None
 

evaluation/aider_bench/README.md

@@ -56,20 +56,6 @@ You can update the arguments in the script
 ./evaluation/aider_bench/scripts/run_infer.sh eval_gpt35_turbo HEAD CodeActAgent 100 1 "1,3,10"
 ```
 
-### Run Inference on `RemoteRuntime` (experimental)
-
-This is in limited beta. Contact Xingyao over slack if you want to try this out!
-
-```bash
-./evaluation/aider_bench/scripts/run_infer.sh [model_config] [git-version] [agent] [eval_limit] [eval-num-workers] [eval_ids]
-
-# Example - This runs evaluation on CodeActAgent for 133 instances on aider_bench test set, with 2 workers running in parallel
-export ALLHANDS_API_KEY="YOUR-API-KEY"
-export RUNTIME=remote
-export SANDBOX_REMOTE_RUNTIME_API_URL="https://runtime.eval.all-hands.dev"
-./evaluation/aider_bench/scripts/run_infer.sh llm.eval HEAD CodeActAgent 133 2
-```
-
 ## Summarize Results
 
 ```bash

evaluation/aider_bench/run_infer.py

@@ -15,7 +15,6 @@ from evaluation.aider_bench.helper import (
 from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -58,9 +57,6 @@ def get_config(
             use_host_network=False,
             timeout=100,
             api_key=os.environ.get('ALLHANDS_API_KEY', None),
-            remote_runtime_api_url=os.environ.get('SANDBOX_REMOTE_RUNTIME_API_URL'),
-            keep_runtime_alive=False,
-            remote_runtime_init_timeout=1800,
         ),
         # do not mount workspace
         workspace_base=None,
@@ -254,7 +250,7 @@ def process_instance(
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
     metrics = state.metrics.get() if state.metrics else None
 
     # Save the output

evaluation/biocoder/run_infer.py

@@ -13,7 +13,6 @@ from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
     codeact_user_response,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -40,7 +39,7 @@ AGENT_CLS_TO_FAKE_USER_RESPONSE_FN = {
 }
 
 AGENT_CLS_TO_INST_SUFFIX = {
-    'CodeActAgent': 'When you think you have fixed the issue through code changes, please finish the interaction using the "finish" tool.\n'
+    'CodeActAgent': 'When you think you have fixed the issue through code changes, please run the following command: <execute_bash> exit </execute_bash>.\n'
 }
 
 FILE_EXT_MAP = {
@@ -300,7 +299,7 @@ def process_instance(
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     test_result['generated'] = test_result['metadata']['1_copy_change_code']
 

evaluation/bird/run_infer.py

@@ -16,7 +16,6 @@ from tqdm import tqdm
 from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -40,21 +39,21 @@ from openhands.utils.async_utils import call_async_from_sync
 def codeact_user_response(state: State) -> str:
     msg = (
         'Please continue working on the task on whatever approach you think is suitable.\n'
-        'If you think you have completed the SQL, please finish the interaction using the "finish" tool.\n'
+        'If you think you have completed the SQL, please run the following command: <execute_bash> exit </execute_bash>.\n'
         'IMPORTANT: YOU SHOULD NEVER ASK FOR HUMAN HELP OR USE THE INTERNET TO SOLVE THIS TASK.\n'
     )
     if state.history:
         # check if the agent has tried to talk to the user 3 times, if so, let the agent know it can give up
         user_msgs = [
             event
-            for event in state.history
+            for event in state.history.get_events()
             if isinstance(event, MessageAction) and event.source == 'user'
         ]
         if len(user_msgs) > 2:
             # let the agent know that it can give up when it has tried 3 times
             return (
                 msg
-                + 'If you want to give up, use the "finish" tool to finish the interaction.\n'
+                + 'If you want to give up, run: <execute_bash> exit </execute_bash>.\n'
             )
     return msg
 
@@ -64,7 +63,7 @@ AGENT_CLS_TO_FAKE_USER_RESPONSE_FN = {
 }
 
 AGENT_CLS_TO_INST_SUFFIX = {
-    'CodeActAgent': 'When you think you have fixed the issue through code changes, please finish the interaction using the "finish" tool.\n'
+    'CodeActAgent': 'When you think you have fixed the issue through code changes, please run the following command: <execute_bash> exit </execute_bash>.\n'
 }
 
 
@@ -432,7 +431,7 @@ def process_instance(
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     # Save the output
     output = EvalOutput(

evaluation/browsing_delegation/run_infer.py

@@ -9,7 +9,6 @@ from datasets import load_dataset
 from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -90,7 +89,7 @@ def process_instance(
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     # find the last delegate action
     last_delegate_action = None

evaluation/discoverybench/README.md

@@ -1,37 +0,0 @@
-# DiscoveryBench with OpenHands
-
-[DiscoveryBench](https://github.com/allenai/discoverybench/) [(Paper)](https://arxiv.org/abs/2407.01725v1) contains 264 tasks collected across 6 diverse domains, such as biology, economics, and sociology. It incorporates discovery workflows from published papers to approximate the real-world challenges faced by researchers.
-
-<p align="center">
-  <a href="[https://github.com/allenai/discoverybench](https://github.com/allenai/discoverybench)">
-    <img src="https://raw.githubusercontent.com/allenai/discoverybench/refs/heads/main/assets/discoverybench-openhands-teaser.png" width="100%" alt="DiscoveryBench Background" />
-  </a>
-</p>
-
-
-## Setup Environment and LLM Configuration
-
-1. Please follow instructions mentioned [here](https://github.com/openlocus/OpenHands/blob/discoverybench-openhands-integration/evaluation/README.md#setup) to setup OpenHands development environment and LLMs locally
-
-2. Execute the bash script to start DiscoveryBench Evaluation
-
-```
-./evaluation/discoverybench/scripts/run_infer.sh [YOUR MODEL CONFIG]
-```
-Replace `[YOUR MODEL CONFIG]` with any model the model that you have set up in `config.toml`
-
-
-## Run Inference on DiscoveryBench Instances
-
-When the `run_infer.sh` script is started, it will automatically pull the latest DiscoveryBench instances & set up the agent environment. The OpenHands agent is invoked to process the task within this environment, producing a hypothesis. We then evaluate it against the “gold” hypothesis provided by DiscoveryBench. The evaluation result, along with the agent chat history is logged to `output.jsonl` under `evaluation_outputs`.
-
-
-```
-./evaluation/discoverybench/scripts/run_infer.sh [MODEL_CONFIG] [GIT_COMMIT] [AGENT] [EVAL_LIMIT] [NUM_WORKERS]
-```
-
-- `MODEL_CONFIG`: Name of the model you want to evaluate with
-- `GIT_COMMIT`: This should be the git commit hash or release tag for OpenHands, e.g., HEAD or a specific tag like 0.6.2.
-- `AGENT`: Use CoderActAgent, right now it only supports that.
-- `EVAL_LIMIT`: Number of samples to evaluate.
-- `NUM_WORKERS`: Number of workers to parallelize the evaluation process.

evaluation/discoverybench/eval_utils/README.md

@@ -1,7 +0,0 @@
-## DiscoveryBench Evaluation Utils
-
-- **`eval_w_subhypo_gen.py`**: Implements the DiscoveryBench logic for evaluating agent-generated hypotheses.
-- **`lm_utils.py`**: Provides utility functions necessary for the evaluation process.
-- **`openai_helpers.py`**: Includes helper functions for OpenAI-related tasks.
-- **`openai_semantic_gen_prompts.py`**: Contains prompts used for semantic generation.
-- **`response_parser.py`**: Handles the parsing of agent-generated hypotheses.

evaluation/discoverybench/eval_utils/eval_w_subhypo_gen.py

@@ -1,538 +0,0 @@
-import json
-import logging
-
-from openai import OpenAI
-
-from .lm_utils import run_chatgpt_query_multi_turn
-from .openai_helpers import get_response
-
-logging.basicConfig(
-    format='%(asctime)s - %(levelname)s - %(name)s -   %(message)s',
-    datefmt='%m/%d/%Y %H:%M:%S',
-    level=logging.INFO,
-)
-logger = logging.getLogger(__name__)
-
-
-def get_score_from_answer(type, answer):
-    if type == 'context':
-        answer = answer.replace('Answer:', '').strip()
-        if answer.startswith('A)'):
-            return 1.0
-        elif answer.startswith('B)'):
-            return 0.0
-        return -1.0
-
-    elif type == 'var':
-        try:
-            var_json = json.loads(answer)
-            # print(f"var_json:{var_json}")
-            p = 0.0
-            r = 0.0
-            f1 = 0.0
-            if var_json['sizeB']:
-                p = var_json['intersection'] / var_json['sizeB']
-            if var_json['sizeA']:
-                r = var_json['intersection'] / var_json['sizeA']
-            if p > 0.0 and r > 0.0:
-                f1 = (2 * p * r) / (p + r)
-            else:
-                f1 = 0.0
-            eval_rec = {
-                'p': p,
-                'r': r,
-                'f1': f1,
-                'sizeA': var_json['sizeA'],
-                'sizeB': var_json['sizeB'],
-                'intersection': var_json['intersection'],
-                'explanation': var_json['explanation'],
-            }
-            print(f'var_eval: {eval_rec}')
-            return eval_rec
-        except Exception:  # COMMENT: added Exception
-            return {'p': -1.0, 'r': -1.0, 'f1': -1.0}
-    elif type == 'rel':
-        print(answer)
-        rel_json = json.loads(answer)
-        answer_str = rel_json['answer'].strip()
-        if answer_str.startswith('A') or 'very similar' in answer_str:
-            return 1.0
-        elif (
-            answer_str.startswith('B') or 'similar but general than HypoA' in answer_str
-        ):
-            return 0.5
-        elif answer_str.startswith('C') or 'different' in answer_str:
-            return 0.0
-        return -1.0
-    return -1.0
-
-
-def ask_dimension_question(
-    query,
-    gold_hypo,
-    gold_workflow,
-    gen_hypo,
-    gen_workflow,
-    dataset_meta,
-    llm_used,
-    dimension,
-    dataset_type,
-    use_column_metadata=True,
-):
-    dimension_question = ''
-    answer = ''
-    score = 0.0
-    if dimension == 'var':
-        score = {'p': -1.0, 'r': -1.0, 'f1': -1.0}
-    num_tokens = 256
-    num_retries = 1
-    json_response = False
-
-    messages = [
-        {
-            'role': 'system',
-            'content': 'You are an AI assistant that helps evaluate a data-driven hypothesis. You are a helpful assistant who is not talkative. You only respond with the exact answer to a query without additional conversation.',
-        },
-    ]
-    if dimension == 'context':
-        dimension_question = """\
-        Question: Is HypoB defined in the same context as HypoA?
-        (Context refers to assumptions/stratification under which the hypotheses are defined.)
-        Options: A) same   B) different
-        What is your answer?"""
-    elif dimension == 'var':
-        dimension_question = """\
-        Question: For both HypoA and HypoB, what are the different variables found in the hypotheses? \
-        Return your answer as a JSON object in the following format:
-        ```json
-        {{
-        "sizeA": num of variables used in HypoA
-        "sizeB": num of variables used in HypoB
-        "intersection": num of variables common in HypoA and HypoB. Use *fuzzy matching* to determine intersection, accounting for paraphrases or slightly different surface forms
-        "explanation": a short text explanation about the variables
-        }}```
-        Answer:"""
-        num_tokens = 512
-        num_retries = 1
-        json_response = True
-    elif dimension == 'rel':
-        dimension_question = """\
-        Question: Does HypoB exhibit the same relation as HypoA?
-        Compare using following example hierarchy of relationships (based on specificity): \
-        "there exists a relationship" > "positive relationship" > "positive AND (linear OR quadratic)" > "positive AND linear".
-        Options: A) very similar B) similar but general than HypoA C) different
-        Return your answer as a JSON object in the following format:
-        ```json
-        {{
-        "answer": one of the options from A) very similar B) similar but general than HypoA C) different
-        "explanation": a short text explanation about the relationship comparison
-        }}```
-        Answer:"""
-        num_tokens = 512
-        num_retries = 1
-        json_response = True
-
-    datasets_json = prepare_dataset_metadata_json(
-        dataset_meta, dataset_type=dataset_type, use_column_metadata=use_column_metadata
-    )
-
-    dimension_question_str = f"""\
-        You are going to compare two natural-language hypotheses HypoA and HypoB accompanied with optional workflows: WorkflowA for HypoA and WorkflowB for HypoB. \
-        Both the hypotheses answer the natural language query "QUERY" over the dataset(s) described by dataset description(s) and column description(s) below. \
-        Compare HypoA and HypoB in terms of three aspects: Contexts, Variables, and Relations. \
-        E.g., for the hypothesis "From 1995 to 2009, the number of sandhill cranes around the tundra (Indigilka River) surged by an astounding ~10X":
-        * Contexts refer to stratification of the data under which the given hypothesis is True. E.g., "For all women", "From 1995 to 2009".
-        * Variables refer to the set of variables (either dependent or independent) that are mentioned in the hypothesis. E.g., number of sandhill cranes, location.
-        * Relations refer to the form of relation between the variables. E.g., "surged by ~10x".
-
-        Answer following questions for a given pair of hypotheses, HypoA and HypoB, along with an explanation grounded on the QUERY and the DATASET(S).
-
-        Here is the metadata for the task:
-        ```json
-        {{
-        "datasets": {datasets_json},
-        "query": {query},
-        "HypoA": {gold_hypo},
-        "WorkflowA": {gold_workflow},
-        "HypoB": {gen_hypo},
-        "WorkflowB": {gen_workflow}
-        }}
-        ```
-
-        {dimension_question}"""
-
-    messages.append({'role': 'user', 'content': dimension_question_str})
-    for retry in range(num_retries):
-        response = run_chatgpt_query_multi_turn(
-            messages=messages,
-            model_name=llm_used,
-            max_tokens=num_tokens,
-            temperature=0,  # 0 for greedy best decoding
-            json_response=json_response,
-        )
-        if response is not None:  # COMMENT: changed from != to is not
-            break
-
-    if response is not None:  # COMMENT: changed from != to is not
-        answer = response.choices[0].message.content.strip()
-        score = get_score_from_answer(type=dimension, answer=answer)
-
-    return dimension_question, answer, score
-
-
-def prepare_dataset_metadata_json(dataset_meta, dataset_type, use_column_metadata=True):
-    if dataset_meta is None:  # COMMENT: changed from == to is None
-        return [
-            {
-                'dataset_description': '',
-                'columns': [],
-            }
-        ]
-    datasets_json = []
-    if dataset_type == 'real':
-        for d in dataset_meta['datasets']:
-            datasets_json.append(
-                {
-                    'dataset_description': d['description'],
-                    'columns': [
-                        {'name': col['name'], 'description': col['description']}
-                        for col in d['columns']['raw']
-                    ]
-                    if use_column_metadata
-                    else [],
-                }
-            )
-    else:
-        for d in dataset_meta['datasets']:
-            datasets_json.append(
-                {
-                    'dataset_description': d['description'],
-                    'columns': [
-                        {'name': col['name'], 'description': col['description']}
-                        for col in d['columns']
-                    ]
-                    if use_column_metadata
-                    else [],
-                }
-            )
-    return datasets_json
-
-
-def get_sub_hypotheses(
-    query,
-    hypo,
-    workflow,
-    dataset_meta,
-    llm_used,
-    dataset_type,
-    use_column_metadata=True,
-):
-    client = OpenAI()
-    extraction_prompt = """\
-        Given a set of dataset columns, a ground-truth hypothesis, and the analysis workflow used, your task is to extract three dimensions that define the hypothesis: Context, Variables, and Relations. \
-        Here are the definitions for these dimensions:
-        - Contexts: Boundary conditions that limit the scope of a hypothesis. E.g., “for men over \
-        the age of 30”, “in Asia and Europe”. If the context applies to the full dataset, then extract the context from the dataset_descrption.
-        - Variables: Known concepts that interact in a meaningful way under a given context to \
-        produce the hypothesis. E.g., gender, age, income, or "None" if there is no interacting variable.
-        - Relations: Interactions between a given set of variables under a given context to produce \
-        the hypothesis. E.g., “quadratic relationship”, “inversely proportional”, piecewise conditionals, \
-        or "None" if there is no interacting relationship.
-        Make sure to only use the information present in the hypothesis and the workflow. Do not add any new information. \
-        For each dimension, be specific, and do not omit any important details.
-
-        Here is the metadata for the task:
-        ```json
-        {
-        "datasets": %s,
-        "hypothesis": "%s",
-        "workflow": "%s"
-        }
-        ```
-
-        Return your answer as a JSON object in the following format:
-        ```json
-        {
-        "sub_hypo": [
-            {
-                "text": the hypothesis in natural language,
-                "context": a short text description of the context of the hypothesis,
-                "variables": a list of columns involved in the hypothesis,
-                "relations": a short text description of the relationship between the variables of the hypothesis
-            },
-            ...
-        ]
-        }```
-        """
-    datasets_json = prepare_dataset_metadata_json(
-        dataset_meta, dataset_type, use_column_metadata=use_column_metadata
-    )
-    _prompt = extraction_prompt % (datasets_json, hypo, workflow)
-    sub_hypo_json = get_response(client, _prompt, model=llm_used, max_retry=1)
-
-    if sub_hypo_json is not None:  # COMMENT: changed from != to is not
-        # print(f"full hypothesis: {hypo}")
-        print(f'sub_hypo_json: {sub_hypo_json}')
-    else:
-        sub_hypo_json = {
-            'sub_hypo': [],
-        }
-
-    sub_hypo_json['full_hypo'] = hypo
-
-    return sub_hypo_json
-
-
-def match_context_with_gpt(
-    gold_hyp, gold_context, pred_hyp, pred_context, model='gpt-3.5-turbo'
-):
-    prompt = f"""\
-        Given a gold hypothesis, a gold context, a predicted hypothesis, and a predicted context, your task is \
-        to determine if the predicted context semantically matches the ground-truth context. \
-        Here is the definition for Context: Boundary conditions that limit the scope of a sub-hypothesis. E.g., “for men over the age of 30”, “in Asia and Europe”. If the context applies to the full dataset, then the context is derived from the dataset_descrption. \
-        Here is the definition for Context: Boundary conditions that limit the scope of a sub-hypothesis. E.g., “for men over the age of 30”, “in Asia and Europe”. If the context applies to the full dataset, then the context is derived from the dataset_descrption. \
-        If the predicted context matches the gold context, return true, otherwise return false.
-        If both gold and predicted hypotheses are defined over the context of the full dataset, then also return true.
-        If both gold and predicted hypotheses are defined over the context of the full dataset, then also return true.
-
-        Here is the metadata for the task:
-        ```json
-        {{
-            "gold_hypothesis": "{gold_hyp}",
-            "gold_context": "{gold_context}",
-            "predicted_hypothesis": "{pred_hyp}",
-            "predicted_context": "{pred_context}"
-        }}
-        ```
-
-        Return your answer as a JSON object in the following format:
-        ```json
-        {{
-            "match": true or false
-        }}
-        ```"""
-
-    client = OpenAI()
-    output = get_response(client, prompt, model=model)
-    return output.get('match', False)
-
-
-def is_matching_context(gold_hyp, gold_context, pred_hyp, pred_context, llm_used):
-    if gold_context == pred_context:
-        return True
-    if 'None' in [gold_context, pred_context]:
-        return False
-    return match_context_with_gpt(
-        gold_hyp, gold_context, pred_hyp, pred_context, model=llm_used
-    )
-
-
-def run_eval_gold_vs_gen_NL_subhypo(
-    query,
-    gold_hypo,
-    gold_workflow,
-    gen_hypo,
-    gen_workflow,
-    dataset_meta,
-    llm_used,
-    context_score,
-    dataset_type,
-    use_column_metadata=True,
-):
-    # GPT-4 based evaluation to evaluate generated hypothesis in terms of context, variables, relation
-
-    eval_rec = {
-        'query': query,
-        'HypoA': gold_hypo,
-        'WorkflowA': gold_workflow,
-        'HypoB': gen_hypo,
-        'WorkflowB': gen_workflow,
-    }
-
-    for dimension in ['var', 'rel']:
-        question, answer, score = ask_dimension_question(
-            query,
-            gold_hypo,
-            gold_workflow,
-            gen_hypo,
-            gen_workflow,
-            dataset_meta,
-            llm_used,
-            dimension=dimension,
-            dataset_type=dataset_type,
-            use_column_metadata=use_column_metadata,
-        )
-
-        eval_rec[dimension] = {'question': question, 'answer': answer, 'score': score}
-
-    eval_rec['context'] = context_score
-    eval_rec['accuracy_score'] = (
-        1.0
-        * eval_rec['context']['score']
-        * eval_rec['var']['score']['f1']
-        * eval_rec['rel']['score']
-    )
-
-    return eval_rec
-
-
-def run_eval_gold_vs_gen_NL_hypo_workflow(
-    query,
-    gold_hypo,
-    gold_workflow,
-    gen_hypo,
-    gen_workflow,
-    dataset_meta,
-    llm_used,
-    dataset_type,
-    use_column_metadata=True,
-):
-    # Input: Dataset Metadata, Query, Gold {Hg, Wg}, Predicted {Hp, Wp}
-    # Output: eval_rec json includes final_score
-
-    # Procedure:
-    # Dataset Metadata, Query, Gold {Hg, Wg}, Pred {Hg, Wg}
-    # Gold: [Hg1, Hg2] (compute on the fly) Hg1 is a NL form of subhypothesis
-    # Predicted: [Hp1, Hp2] (compute on the fly)
-
-    # Compute Intersection: [(Hg_i, Hp_j), …]  # tuples of (gold,pred) that matched with context (do this w/o explicit extraction)
-    # # filter so that a gold context and a predicted context are only attached to one tuple
-    # Compute recall_context (programmatically)
-
-    # r_v_list = []
-    # For (Hg_i, Hp_j) in the intersection:
-    #             With Hg_i, Hp_j in NL, ask GPT4 → #variables and #intersection and a paragraph explanation and programmatically calculate f1_v
-    # Hg_i, Hp_j in NL, ask GPT4 → matching score (0, 0.5 or 1) : A) very similar B) similar but general than HypoA C) different + explanation
-    # 	r_v_list ← f1_v * score_r
-    # accuracy_score = mean(r_v_list)
-    # score =   [ recall_context * mean over predicted context(context_score * var_score *rel_score )]
-
-    # recall_context = 1.0  # COMMENT: never used
-    eval_rec = {
-        'query': query,
-        'HypoA': gold_hypo,
-        'WorkflowA': gold_workflow,
-        'HypoB': gen_hypo,
-        'WorkflowB': gen_workflow,
-    }
-
-    gold_sub_hypo_json = get_sub_hypotheses(
-        query=query,
-        hypo=gold_hypo,
-        workflow=gold_workflow,
-        dataset_meta=dataset_meta,
-        llm_used=llm_used,
-        dataset_type=dataset_type,
-        use_column_metadata=use_column_metadata,
-    )
-    if len(gold_sub_hypo_json['sub_hypo']) == 0:
-        gold_sub_hypo_json['sub_hypo'] = [
-            {
-                'text': gold_hypo,
-                'context': 'None',
-                'variables': [],
-                'relations': '',
-                'explanation': 'unable to segment',
-            }
-        ]
-    print(f'gold_sub_hypo_json: {gold_sub_hypo_json}')
-
-    gen_sub_hypo_json = get_sub_hypotheses(
-        query=query,
-        hypo=gen_hypo,
-        workflow=gen_workflow,
-        dataset_meta=dataset_meta,
-        llm_used=llm_used,
-        dataset_type=dataset_type,
-        use_column_metadata=use_column_metadata,
-    )
-    if len(gen_sub_hypo_json['sub_hypo']) == 0:
-        gen_sub_hypo_json['sub_hypo'] = [
-            {
-                'text': gen_hypo,
-                'context': 'None',
-                'variables': [],
-                'relations': '',
-                'explanation': 'unable to segment',
-            }
-        ]
-    print(f'gen_sub_hypo_json: {gen_sub_hypo_json}')
-
-    eval_rec['gold_sub_hypo'] = gold_sub_hypo_json
-    eval_rec['gen_sub_hypo'] = gen_sub_hypo_json
-
-    gold_subh_covered = []
-    gen_subh_to_gold_subh = dict()
-    gen_gold_subh_to_context = dict()
-
-    for p_id, gen_subh in enumerate(gen_sub_hypo_json['sub_hypo']):
-        gen_subh_to_gold_subh[p_id] = -1
-
-        for g_id, gold_subh in enumerate(gold_sub_hypo_json['sub_hypo']):
-            if g_id in gold_subh_covered:
-                continue
-
-            # match context
-            context_bool = is_matching_context(
-                gold_subh['text'],
-                gold_subh.get('context', ''),
-                gen_subh['text'],
-                gen_subh.get('context', ''),
-                llm_used,
-            )
-            if context_bool:
-                context_score = 1.0
-            else:
-                context_score = 0.0
-
-            if context_score == 1.0:  # match only when context_score = 1.0
-                gen_subh_to_gold_subh[p_id] = g_id
-                gold_subh_covered.append(g_id)
-                gen_gold_subh_to_context[f'P{p_id}||G{g_id}'] = {
-                    'question': f"""Comapring: GoldH: {gold_subh["text"]}, GoldC: {gold_subh['context']}\nGenH: {gen_subh['text']}, GenC: {gen_subh['context']}""",
-                    'answer': context_bool,
-                    'score': context_score,
-                }
-                break
-
-    print(f'gen_subh_to_gold_subh: {gen_subh_to_gold_subh}')
-    eval_rec['gen_subh_to_gold_subh'] = gen_subh_to_gold_subh
-    eval_rec['gold_subh_covered'] = gold_subh_covered
-    matched_gold_gen_subh_evals = dict()
-    sum_accuracy_score = 0.0
-    for p_id, g_id in gen_subh_to_gold_subh.items():
-        if g_id >= 0:
-            key = f'P{p_id}||G{g_id}'
-            context_score = gen_gold_subh_to_context[key]
-            subh_eval_rec = run_eval_gold_vs_gen_NL_subhypo(
-                query,
-                gold_hypo,
-                gold_workflow,
-                gen_hypo,
-                gen_workflow,
-                dataset_meta,
-                llm_used,
-                context_score,
-                dataset_type=dataset_type,
-                use_column_metadata=use_column_metadata,
-            )
-            sum_accuracy_score += subh_eval_rec['accuracy_score']
-            matched_gold_gen_subh_evals[key] = subh_eval_rec
-
-    eval_rec['matched_gold_gen_subh_evals'] = matched_gold_gen_subh_evals
-    eval_rec['recall_context'] = (
-        len(gold_subh_covered) / len(gold_sub_hypo_json['sub_hypo'])
-        if len(gold_sub_hypo_json['sub_hypo'])
-        else 0.0
-    )
-    mean_accuracy_score = (
-        sum_accuracy_score / len(gen_subh_to_gold_subh)
-        if len(gen_subh_to_gold_subh)
-        else 0.0
-    )
-    eval_rec['mean_accuracy_score'] = mean_accuracy_score
-    final_score = eval_rec['recall_context'] * mean_accuracy_score
-    eval_rec['final_score'] = final_score
-    print(f'eval_rec: {json.dumps(eval_rec, indent=2)}')
-
-    return eval_rec

evaluation/discoverybench/eval_utils/lm_utils.py

@@ -1,64 +0,0 @@
-import os
-import sys
-import time
-
-from openai import OpenAI
-from tenacity import (
-    retry,
-    stop_after_attempt,  # type: ignore
-    wait_random_exponential,  # type: ignore
-)
-
-if sys.version_info >= (3, 8):
-    from typing import Literal
-else:
-    from typing_extensions import Literal
-
-
-Model = Literal['gpt-4', 'gpt-3.5-turbo', 'text-davinci-003']
-
-OpenAI.api_key = os.getenv('OPENAI_API_KEY')
-OPENAI_GEN_HYP = {
-    'temperature': 0,
-    'max_tokens': 250,
-    'top_p': 1.0,
-    'frequency_penalty': 0,
-    'presence_penalty': 0,
-}
-
-
-@retry(wait=wait_random_exponential(min=1, max=60), stop=stop_after_attempt(6))
-def run_chatgpt_query_multi_turn(
-    messages,
-    model_name='gpt-4-turbo',  # pass "gpt4" for more recent model output
-    max_tokens=256,
-    temperature=0.0,
-    json_response=False,
-):
-    response = None
-    num_retries = 3
-    retry = 0
-    while retry < num_retries:
-        retry += 1
-        try:
-            client = OpenAI()
-
-            if json_response:
-                response = client.chat.completions.create(
-                    model=model_name,
-                    response_format={'type': 'json_object'},
-                    messages=messages,
-                    **OPENAI_GEN_HYP,
-                )
-            else:
-                response = client.chat.completions.create(
-                    model=model_name, messages=messages, **OPENAI_GEN_HYP
-                )
-            break
-
-        except Exception as e:
-            print(e)
-            print('GPT error. Retrying in 2 seconds...')
-            time.sleep(2)
-
-    return response

evaluation/discoverybench/eval_utils/openai_helpers.py

@@ -1,190 +0,0 @@
-import json
-
-
-def OPENAI_TOPIC_GEN_MESSAGES(n=10):
-    return [
-        {
-            'role': 'system',
-            'content': 'You are a helpful assistant who is not talkative. You only respond with the exact answer to a query without additional conversation.',
-        },
-        {
-            'role': 'user',
-            'content': f'Given `n`, come up with a list of `n` distinct topics and their descriptions. The topics can be absolutely anything. Be as creative as possible. Return your answer as a JSON object. \n\nFor example, for `n`=3, a valid answer might be:\n```json\n{{"topics": [\n  {{"id": 1, "topic": "cooking", "description": "Related to recipes, ingredients, chefs, etc."}},\n  {{"id": 2, "topic": "sports", "description": "Related to players, stadiums, trophies, etc."}},\n  {{"id": 3, "topic": "antiquing", "description": "Related to unique items, history, etc."}}\n]}}```\n\nNow, give me a list for `n`={n}. Remember, pick diverse topics from everything possible. No consecutive topics should be broadly similar. Directly respond with the answer JSON object.',
-        },
-    ]
-
-
-OPENAI_GEN_HYP = {
-    'temperature': 1.0,
-    'max_tokens': 4096,
-    'top_p': 1.0,
-    'frequency_penalty': 0,
-    'presence_penalty': 0,
-}
-
-
-def OPENAI_SEMANTICS_GEN_MESSAGES(dependent, relationship, domain, domain_desc):
-    return [
-        {
-            'role': 'system',
-            'content': 'You are a helpful assistant who is not talkative. You only respond with the exact answer to a query without additional conversation.',
-        },
-        {
-            'role': 'user',
-            'content': f'Given the true relationship in a dataset and a given domain, your task is to come up with an interpretation of some real-world concepts that the relationship could be modeling from the provided domain. It\'s okay to be wrong, but suggest something reasonable. Try as much as possible to make sure that the TARGET is actually derivable from the other variables. Give your answer as a JSON object. Here\'s an example:\n\nRelationship for x2 = "(96.4 * x1 ** 3) + (88.72 * x5 ** 2) + (81.96 * x6 ** -2) + (28.13 * x3)  + (97.0) + (0 * x4)"\nDomain="Sales"\nDomain description="Related to product distribution, revenues, marketing, etc."\n\nBased on this, the following real-world concepts might be applicable:\n```json\n{{\n  "dependent": "x2",\n  "relationship": "(96.4 * x1 ** 3) + (88.72 * x5 ** 2) + (81.96 * x6 ** -2) + (28.13 * x3)  + (97.0) + (0 * x4)",\n  "domain": "Sales",\n  "trends": {{\n    "x1": "Positive, cubic factor",\n    "x2": "TARGET",\n    "x3": "Positive, linear factor",\n    "x4": "No relation",\n    "x5": "Positive quadratic factor",\n    "x6": "Positive, inverse quadratic factor"\n  }},\n  "interpretation": {{\n    "x2": {{"description": "Volume of product sales by area", "name": "sales_area", "is_target": true}},\n    "x1": {{"description": "Population by area", "name": "pop_area"}},\n    "x3": {{"description": "Advertising spending", "name": "ad_spend"}},\n    "x4": {{"description": "Gender ratio of marketing team", "name": "gdr_ratio_mkt_team"}},\n    "x5": {{"description": "Intensity of marketing campaign", "name": "mkt_intensity"}}\n  }},\n    "x6": {{"description": "Distance to distribution center", "name": "dist_to_distr_ctr"}}\n}}```\n\nHere\'s a new test question:\nRelationship for {dependent} = "{relationship}"\nDomain = "{domain}"\nDomain description="{domain_desc}"\n\nRespond only with the answer JSON. Make sure that you do not forget to include the TARGET variable in the interpretation object.',
-        },
-    ]
-
-
-def OPENAI_SEMANTICS_GEN_W_MAP_MESSAGES(
-    dependent, relationship, domain, domain_desc, mapping
-):
-    return [
-        {
-            'role': 'system',
-            'content': 'You are a helpful assistant who is not talkative. You only respond with the exact answer to a query without additional conversation.',
-        },
-        {
-            'role': 'user',
-            'content': f'Given a partial mapping from variables to real-world concepts and a true relationship in a dataset, your task is to come up with an interpretation of real-world concepts for the variables without any assigned mapping (those starting with x). Suggest something reasonable. The dependent variable must be derivable only from the other variables in the dependent relationship. Give your answer as a JSON object. Here\'s an example:\n\nExample partial mapping and relationship:\n```json\n{{\n  "domain": "Sales",\n  "domain_description": "Related to product distribution, revenues, marketing, etc.",\n  "variable_mapping": {{\n    "x1": {{"description": "Population by area", "name": "pop_area"}},\n    "x2": {{"description": "Volume of product sales by area", "name": "sales_area"}},\n    "x4": {{"description": "Gender ratio of marketing team", "name": "gdr_ratio_mkt_team"}},\n    "x6": {{"description": "Distance to distribution center", "name": "dist_to_distr_ctr"}}\n  }},\n  "dependent_variable": "sales_area",\n  "dependent_relationship": "(96.4 * pop_area ** 3) + (88.72 * x5 ** 2) + (81.96 * dist_to_distr_ctr ** -2) + (28.13 * x3)  + (97.0)"\n}}```\nBased on this, an example answer would be:\n```json\n{{\n  "dependent_variable": "sales_area",\n  "missing_mapping": ["x3", "x5"],\n  "trends": {{\n    "x3": "Positive, linear factor",\n    "x5": "Positive quadratic factor"\n  }},\n  "interpretation": {{\n    "x3": {{"description": "Advertising spending", "name": "ad_spend"}},\n    "x5": {{"description": "Intensity of marketing campaign", "name": "mkt_intensity"}}\n  }}\n}}```\n\nHere\'s a new test question:\n```json\n{{\n  "domain": "{domain}",\n  "domain_description": "{domain_desc}",\n  "variable_mapping": {json.dumps(mapping, indent=2)},\n  "dependent_variable": "{dependent}",\n  "dependent_relationship": "{relationship}"\n}}```\nRespond only with the answer JSON.',
-        },
-    ]
-
-
-def OPENAI_SEMANTICS_GEN_SUMMARY_MESSAGES(dataset):
-    return [
-        {
-            'role': 'system',
-            'content': 'You are a helpful assistant who is not talkative. You only respond with the exact answer to a query without additional conversation.',
-        },
-        {
-            'role': 'user',
-            'content': f'Given the following descriptions of the columns of a dataset, your task is to come up with a natural language overview of the dataset, which should include (1) what the dataset is about, (2) how the data was collected, (3) when the data was collected, and (3) for what purpose the data was collected. Be specific and creative.\n\nExample dataset:\n```json\n{{  \n  "dataset": {{                                                                                                                                                                                       \n    "x6": {{"description": "Ancient artifact significance score", "name": "artifact_significance_score", "is_target": true}},\n    "x1": {{"description": "Distance to ancient city center", "name": "dist_to_ancient_city_ctr"}},\n    "x2": {{"description": "Quantity of discovered relics", "name": "relic_discovery_qty"}},\n    "x3": {{"description": "Years since last archaeological expedition", "name": "years_since_exp"}},\n    "x4": {{"description": "Number of artifacts in excavation site", "name": "artifact_qty"}},\n    "x5": {{"description": "Soil fertility coefficient", "name": "soil_fertility_coef"}},\n    "x7": {{"description": "Distance to ancient burial grounds", "name": "dist_to_burial_grounds"}},\n    "x8": {{"description": "Population estimate of ancient civilization", "name": "ancient_civilization_pop_estimate"}},\n    "x9": {{"description": "Temperature variation in excavation region", "name": "temp_variation"}}\n  }}\n}}```\nExample description:\nThis dataset is about archaeological explorations and findings linked to ancient civilizations. The data was collected in the form of field metrics during various archaeological expeditions during the late mid-20th century. The purpose of the data collection is to evaluate the significance of ancient artifacts discovered during excavations.\n\nHere is a new test dataset.\n{json.dumps(dataset, indent=2)}\nProvide only the description.',
-        },
-    ]
-
-
-def OPENAI_GEN_HYPO_MESSAGES(dataset):
-    return [
-        {
-            'role': 'system',
-            'content': 'You are a helpful assistant who is not talkative. You only respond with the exact answer to a query without additional conversation.',
-        },
-        {
-            'role': 'user',
-            'content': f'Given a dataset with its descriptions and the true functional relationship between its variables, your task is to generate 3 levels of hypotheses for the stated relationship in plain English. The three levels are "broad", "medium" and "narrow". Make sure that the hypotheses sound natural. *Only include concepts for variables that are present in the provided functional relationship.* Give your answer as a JSON.\n\nFor example, an example dataset might be the following:\n```json\n{{\n  "domain": "cybersecurity",\n  "summary": "This dataset is about measuring cybersecurity threats in a system. The data was collected by monitoring various cybersecurity metrics in a network environment. The purpose of the data collection is to assess and predict potential cybersecurity risks and vulnerabilities.",\n  "variables": [\n    {{\n      "description": "Level of cybersecurity threat",\n      "name": "cybersecurity_threat",\n      "is_target": true\n    }},\n    {{\n      "description": "Number of failed login attempts",\n      "name": "failed_login_attempts"\n    }},\n    {{\n      "description": "Amount of encrypted data",\n      "name": "encrypted_data"\n    }},\n    {{\n      "description": "Frequency of software updates",\n      "name": "software_updates"\n    }},\n    {{\n      "description": "Number of antivirus software installed",\n      "name": "antivirus_software"\n    }},\n    {{\n      "description": "Quality of firewall protection",\n      "name": "firewall_quality"\n    }}\n  ],\n  "relationship": {{\n    "dependent": "cybersecurity_threat",\n    "relation": "-53.5*encrypted_data**2 - 53.85*failed_login_attempts**2 + 67.75*firewall_quality - 92.16 - 36.68/software_updates**3"\n  }}\n}}```\nGiven this dataset, the following is a valid answer:\n```json\n{{\n  "broad": {{\n    "instruction": "Be vague. Only indicate which concepts might be related but not how they are related",\n    "hypothesis": "Threat to cybersecurity is influenced by several factors including the amount of encrypted data, the number of failed login attempts, the quality of the firewall, as well as how often the software is updated."\n  }},\n  "medium": {{\n    "instruction": "Be slightly more specific. For each factor, indicate carefully whether it positively or negatively affects the relationship, but do not indicate what the exponent is.",\n    "hypothesis": "Cybersecurity threat tends to decrease with the amount of data encryption, the number of failed login attempts, as well as the frequency of software updates to some extent, while improvement in the firewall quality has a positive effect."\n  }},\n  "narrow": {{\n    "instruction": "Be specific. Communicate the concepts, whether there is a positive or negative effect (be careful), and the meaning of the exponent",\n    "hypothesis": "The threat to cybersecurity interacts in a complex manner with various factors. As the amount of encrypted data increases, there is a quadratic decrease in threat. Similarly for the number of failed login attempts, there is a negative quadratic relationship. The quality of the firewall protection on the other hand demonstrates a positive and linear relationship. Finally, the frequency of software updates has an inverse cubic relationship to the threat."\n  }},\n}}\n```\n\nBased on this, provide an answer for the following test dataset:\n```json\n{dataset}```\nRespond only with a JSON.',
-        },
-    ]
-
-
-def create_prompt(usr_msg):
-    return [
-        {
-            'role': 'system',
-            'content': 'You are a helpful assistant who is not talkative. You only respond with the exact answer to a query without additional conversation.',
-        },
-        {'role': 'user', 'content': usr_msg},
-    ]
-
-
-def get_response(client, prompt, max_retry=5, model='gpt-3.5-turbo', verbose=False):
-    n_try = 0
-    while n_try < max_retry:
-        response = client.chat.completions.create(
-            model=model, messages=create_prompt(prompt), **OPENAI_GEN_HYP
-        )
-
-        # COMMENT: changed from
-        # response.choices[0].message.content.strip().strip('```json').strip('```')
-        content = response.choices[0].message.content
-        cleaned_content = content.split('```json')[1].split('```')[0].strip()
-        output = cleaned_content
-        try:
-            response_json = json.loads(output)
-            return response_json
-        except ValueError:
-            if verbose:
-                print(f'Bad JSON output:\n\n{output}')
-            n_try += 1
-            if n_try < max_retry:
-                if verbose:
-                    print('Retrying...')
-            else:
-                if verbose:
-                    print('Retry limit reached')
-    return None
-
-
-def get_code_fix(
-    client, code, error, max_retry=5, model='gpt-3.5-turbo', verbose=False
-):
-    prompt = f"""\
-Given the following code snippet and error message, provide a single-line fix for the error. \
-Note that the code is going to be executed using python `eval`. \
-The code should be executable and should not produce the error message. Be as specific as possible.
-
-Here's the code and the error:
-{{
-    "code": "{code}",
-    "error": "{error}"
-}}
-
-Return only a JSON object with the fixed code in the following format:
-```json
-{{
-    "fixed_code": "..."
-}}"""
-    response = get_response(
-        client, prompt, max_retry=max_retry, model=model, verbose=verbose
-    )
-    return response
-
-
-def get_new_hypothesis(
-    client, target, old, expr, cols, model='gpt-3.5-turbo', verbose=False
-):
-    prompt = f"""\
-Given a target column from a dataset, a pandas expression to derive the column from existing columns, a list of \
-existing columns, and a previously written hypothesis text, carefully check if the hypothesis text is consistent with \
-the pandas expression or not. If it is consistent, simply return the hypothesis as it is. If it is not consistent, \
-provide a new natural language hypothesis that is consistent with the pandas expression using only the provided \
-information. Be specific.
-
-Here's the information:
-```json
-{{
-    "target_column": "{target}",
-    "pandas_expression": "{expr}",
-    "existing_columns": {json.dumps(cols, indent=4)}
-    "old_hypothesis": "{old}",
-}}```
-
-Give your answer as a new JSON with the following format:
-```json
-{{
-    "hypothesis": "..."
-}}"""
-    response = get_response(client, prompt, model=model, verbose=verbose)
-    return response
-
-
-def replace_variable(client, expr, old, new, model='gpt-3.5-turbo', verbose=False):
-    prompt = f"""\
-Given a pandas "expression", replace mentions of the "old" column with its "new" value such that the resultant \
-expression is equivalent to the original expression.
-
-Here's the information:
-```json
-{{
-    "expression": "{expr}",
-    "old": "{old}",
-    "new": "{new}"
-}}```
-
-Give your answer as a new JSON with the following format:
-```json
-{{
-    "new_expression": "..."
-}}"""
-    response = get_response(client, prompt, model=model, verbose=verbose)
-    return response

evaluation/discoverybench/eval_utils/openai_semantic_gen_prompts.py

@@ -1,151 +0,0 @@
-common_hypothesis_features = [
-    '1-2 sentences',
-    'surprising finding',
-    'includes numeric concepts',
-    'includes categorical concepts',
-    'includes binary concepts',
-]
-hypothesis_features = [
-    ['requires within-cluster analysis'],
-    ['requires across-cluster analysis'],
-    ['corresponds to a polynomial relationship of some columns'],
-    ['corresponds to a ratio between some columns'],
-    ['requires temporal analysis'],
-    ['relationship is based on descriptive statistics of some columns'],
-    ['requires concepts based on percentage or percentiles'],
-    ['relationship is only applicable to one cluster in the data and not the others'],
-]
-
-column_features = [
-    [
-        'must have one target column',
-        'must have quantifiable columns',
-        'must have a few categorical columns',
-        'make sure the categorical column values do not contain special characters',
-        'include a few distractor columns',
-    ]
-]
-
-common_pandas_features = [
-    'must be executable using python `eval` to create the target column in variable `df` (pandas dataframe)',
-    "for e.g., df['A']**2 + 3*df['B'] + 9, np.where(df['A'] > 3, 'Yes', 'No'), etc.",
-    'variables in pandas_expression must be from the existing columns listed above',
-    'variables in pandas_expression must NOT contain the target column itself',
-]
-pandas_features = [
-    ['expression is a quadratic polynomial'],
-    ['expression is a cubic polynomial'],
-    ['expression is a ratio of existing columns'],
-    ['expression is derived through logical combination of existing columns'],
-    # workflow
-]
-pandas_features = [common_pandas_features + p for p in pandas_features]
-
-common_derived_features = [
-    '1-2 sentences',
-    'includes numeric concepts',
-    'includes categorical concepts',
-    'includes binary concepts',
-]
-derived_features = [common_derived_features + h for h in hypothesis_features]
-hypothesis_features = [common_hypothesis_features + h for h in hypothesis_features]
-
-PROMPT_HYP = """\
-Given a dataset topic and description, generate an interesting hypothesis based on \
-the provided instructions. Be creative and come up with an unusual finding.
-
-```json
-{
-    "topic": "%s",
-    "description": "%s",
-    "hypothesis_features": %s,
-    "hypothesis": "..."
-}```
-
-Give your answer as a new JSON with the following format:
-```json
-{
-    "hypothesis": "..."
-}
-```"""
-
-PROMPT_COL = """\
-Given a dataset topic, its description, and a true hypothesis that can be determined from it, \
-generate a list of valid columns based on the provided instructions.
-
-```json
-{
-    "topic": "%s",
-    "description": "%s",
-    "hypothesis": "%s",
-    "column_instructions": %s,
-    "columns": [
-        {
-            "col_name": "...",  # should be an "_"-separated string
-            "description": "...",
-            "data_type": "...",  # should be executable using python's `eval` function. E.g., str, float, int, bool
-            "data_range": {...},  # should be either {"min": ..., "max": ...} or {"values": [...]}
-            "is_distractor": true/false,  # boolean indicating whether this is a distractor that could cause confusion during data analysis
-            "is_target": true/false  # boolean indicating whether this is the target variable for the hypothesis; at least one column should be the target
-        },
-        ...
-    ],
-    "pandas_instructions": %s,
-    "pandas_equation_for_hypothesis": {
-        "target_col": "...",
-        "target_col_type": "...",
-        "target_col_range": {...},
-        "independent_cols_in_pandas_expression": [],  # list of column names that will be used to derive the target column
-        "pandas_expression": "..."  # expression to derive df[target_col] using df[ind_col1], df[ind_col2], etc.
-    }
-}```
-
-Give your answer as a new JSON with the "columns" and "pandas_equation_for_hypothesis" keys filled using the following format:
-```json
-{
-    "columns": [...],
-    "pandas_equation_for_hypothesis": {...}
-}
-```"""
-
-PROMPT_DER = """\
-Given a dataset topic, description, a true hypothesis that can be determined from the data, \
-and a target column from the dataset, generate a hypothesis for the target column using new independent columns not present in the existing columns.
-
-```json
-{
-    "topic": "%s",
-    "description": "%s",
-    "hypothesis": "%s",
-    "existing_columns": %s,
-    "target_column": "%s",
-    "new_to_target_instructions": %s,
-    "new_to_target_hypothesis": "...",  # describe a relationship between new columns that explains the target column
-    "new_columns_for_target": [  # do not repeat any of the existing columns in the dataset
-        {
-            "col_name": "...",  # should be an "_"-separated string
-            "description": "...",
-            "data_type": "...",  # should be executable using python's `eval` function. E.g., str, float, int, bool
-            "data_range": {...},  # should be either {"min": ..., "max": ...} or {"values": [...]}
-        },
-        ...
-    ],
-    "pandas_instructions": %s,
-    "pandas_equation_for_new_to_target_hypothesis": {
-        "target_col": "...",
-        "target_col_type": "...",
-        "target_col_range": {...},
-        "independent_cols_in_pandas_expression": [],  # list of column names from new_columns_for_target that will be used to derive target_col
-        "pandas_expression": "..."  # expression to derive df[target_col] using df[ind_col1], df[ind_col2], etc.
-    }
-}```
-
-Give your answer as a new JSON with the "new_to_target_hypothesis", "new_columns_for_target", and \
-"pandas_equation_for_new_to_target_hypothesis" keys filled using the following format:
-```json
-{
-    "new_to_target_hypothesis": "...",
-    "new_columns_for_target": [...],
-    "pandas_equation_for_new_to_target_hypothesis": {...}
-}
-```"""

evaluation/discoverybench/eval_utils/response_parser.py

@@ -1,52 +0,0 @@
-workflow_summary_markers = [
-    'WORKFLOW SUMMARY',
-    'WORKFLOW_SUMMARY',
-    'WORKFLOW-SUMMARY',
-    'Workflow Summary',
-]
-
-final_answer_markers = [
-    'FINAL ANSWER',
-    'FINAL_ANSWER',
-    'FINAL-ANSWER',
-    'Final Answer',
-    'Scientific Hypothesis',
-    'Hypothesis',
-]
-
-next_agent_markers = [
-    'NEXT AGENT',
-    'NEXT-AGENT',
-    'NEXT_AGENT',
-    'FEEDBACK',
-]
-
-
-def extract_between(content, start_markers, end_markers=None):
-    for marker in start_markers:
-        if marker in content:
-            result = content.split(marker, 1)[1]
-            if end_markers:
-                for end_marker in end_markers:
-                    if end_marker in result:
-                        result = result.split(end_marker, 1)[0]
-            return result
-    return ''
-
-
-def extract_gen_hypo_from_logs(content: str):
-    error = ''
-
-    gen_workflow = extract_between(
-        content, workflow_summary_markers, final_answer_markers
-    )
-
-    if not gen_workflow:
-        error += 'No Workflow Summary found in the line. | '
-
-    gen_hypothesis = extract_between(content, final_answer_markers, next_agent_markers)
-
-    if not gen_hypothesis:
-        error += 'No Final Answer in the line.'
-
-    return gen_hypothesis, gen_workflow, error

evaluation/discoverybench/run_infer.py

@@ -1,489 +0,0 @@
-import asyncio
-import json
-import os
-
-import git
-import pandas as pd
-
-from evaluation.discoverybench.eval_utils.eval_w_subhypo_gen import (
-    run_eval_gold_vs_gen_NL_hypo_workflow,
-)
-from evaluation.discoverybench.eval_utils.response_parser import (
-    extract_gen_hypo_from_logs,
-)
-from evaluation.utils.shared import (
-    EvalMetadata,
-    EvalOutput,
-    codeact_user_response,
-    compatibility_for_eval_history_pairs,
-    make_metadata,
-    prepare_dataset,
-    reset_logger_for_multiprocessing,
-    run_evaluation,
-)
-from openhands.controller.state.state import State
-from openhands.core.config import (
-    AgentConfig,
-    AppConfig,
-    SandboxConfig,
-    get_llm_config_arg,
-    parse_arguments,
-)
-from openhands.core.logger import openhands_logger as logger
-from openhands.core.main import create_runtime, run_controller
-from openhands.events.action import AgentFinishAction, CmdRunAction, MessageAction
-from openhands.events.observation import CmdOutputObservation
-from openhands.runtime.base import Runtime
-from openhands.utils.async_utils import call_async_from_sync
-
-EVALUATION_LLM = 'gpt-4-1106-preview'
-
-DATA_FILES = {}
-
-LIBRARIES = [
-    'pandas',
-    'numpy',
-    'scipy',
-    'matplotlib',
-    'seaborn',
-    'scikit-learn',
-    'statsmodels',
-]
-
-AGENT_CLS_TO_FAKE_USER_RESPONSE_FN = {
-    'CodeActAgent': codeact_user_response,
-}
-
-AGENT_CLS_TO_INST_SUFFIX = {
-    'CodeActAgent': 'When you think you have fixed the issue through code changes, please finish the interaction using the "finish" tool.\n'
-}
-
-
-def get_config(
-    metadata: EvalMetadata,
-) -> AppConfig:
-    config = AppConfig(
-        default_agent=metadata.agent_class,
-        run_as_openhands=False,
-        runtime='eventstream',
-        max_iterations=metadata.max_iterations,
-        sandbox=SandboxConfig(
-            base_container_image='python:3.12-bookworm',
-            enable_auto_lint=True,
-            use_host_network=False,
-        ),
-        # do not mount workspace
-        workspace_base=None,
-        workspace_mount_path=None,
-    )
-    config.set_llm_config(metadata.llm_config)
-    agent_config = AgentConfig(
-        function_calling=False,
-        codeact_enable_jupyter=True,
-        codeact_enable_browsing_delegate=True,
-    )
-    config.set_agent_config(agent_config)
-    return config
-
-
-def get_dv_query_for_real(
-    datasets, question, domain_knowledge=None, workflow_tags=None
-):
-    """
-    Prepare a structured query for the agent to execute on the specified datasets.
-
-    This function constructs a query by compiling metadata from the provided datasets, along with any relevant domain knowledge and workflow tags.
-
-    Args:
-        datasets: List of datasets
-        question: Query to be answered
-        domain_knowledge: Domain knowledge if any
-        workflow_tags: Workflow tags if any
-
-    Returns:
-        query_to_dv: Query to be run on the dataset
-        dataset_meta: Metadata of the dataset
-    """
-
-    dataset_meta = ''
-    for dataset_metadata in datasets:
-        dataset_meta += 'Dataset name: ' + dataset_metadata['name']
-        dataset_meta += 'Dataset description: ' + dataset_metadata['description']
-        dataset_meta += '\nBrief description of columns: '
-        for col in dataset_metadata['columns']['raw']:
-            dataset_meta += col['name'] + ': ' + col['description'] + ', '
-
-    query_to_dv = dataset_meta
-
-    query_to_dv += f'\nQuery: {question}'
-
-    if domain_knowledge:
-        query_to_dv += (
-            '\nAdditionally, we provide some hints that might be useful to solve the task. Domain Knowledge: \n'
-            + domain_knowledge
-            + '.\n'
-        )
-
-    if workflow_tags:
-        query_to_dv += 'The meta tags are: ' + workflow_tags + '.\n'
-
-    query_to_dv += (
-        'In the final answer, please write down a scientific hypothesis in '
-        'natural language, derived from the provided dataset, clearly stating the '
-        'context of hypothesis (if any), variables chosen (if any) and '
-        'relationship between those variables (if any) including any statistical significance.'
-        'Also generate a summary of the full workflow starting from data loading that led to the final answer as WORKFLOW SUMMARY:'
-    )
-
-    # Run the NL query through datavoyager
-    return query_to_dv, dataset_meta
-
-
-def initialize_runtime(runtime: Runtime, data_files: list[str]):
-    """
-    Initialize the runtime for the agent.
-
-    This function is called before the runtime is used to run the agent.
-    """
-    logger.info(f"{'-' * 50} BEGIN Runtime Initialization Fn {'-' * 50}")
-    obs: CmdOutputObservation
-
-    action = CmdRunAction(command='mkdir -p /workspace')
-    logger.info(action, extra={'msg_type': 'ACTION'})
-    obs = runtime.run_action(action)
-    assert obs.exit_code == 0
-
-    action = CmdRunAction(command='cd /workspace')
-    logger.info(action, extra={'msg_type': 'ACTION'})
-    obs = runtime.run_action(action)
-    assert obs.exit_code == 0
-
-    for file in data_files:
-        runtime.copy_to(
-            file,
-            '/workspace',
-        )
-
-    for lib in LIBRARIES:
-        action = CmdRunAction(command=f'pip install {lib}')
-        logger.info(action, extra={'msg_type': 'ACTION'})
-        obs = runtime.run_action(action)
-        assert obs.exit_code == 0
-
-    logger.info(f"{'-' * 50} END Runtime Initialization Fn {'-' * 50}")
-
-
-def get_last_agent_finish_action(state: State) -> AgentFinishAction:
-    for event in reversed(state.history):
-        if isinstance(event, AgentFinishAction):
-            return event
-    return None
-
-
-def get_last_message_action(state: State) -> MessageAction:
-    for event in reversed(state.history):
-        if isinstance(event, MessageAction):
-            return event
-    return None
-
-
-def complete_runtime(state: State):
-    last_agent_finish_action = get_last_agent_finish_action(state)
-    last_agent_message_action = get_last_message_action(state)
-
-    if last_agent_finish_action is not None:
-        final_message_1 = last_agent_finish_action.thought
-        gen_hypo_1, gen_workflow_1, error_1 = extract_gen_hypo_from_logs(
-            final_message_1
-        )
-    else:
-        gen_hypo_1, gen_workflow_1, error_1 = '', '', ''
-
-    if last_agent_message_action is not None:
-        final_message_2 = last_agent_message_action.content
-        gen_hypo_2, gen_workflow_2, error_2 = extract_gen_hypo_from_logs(
-            final_message_2
-        )
-    else:
-        gen_hypo_2, gen_workflow_2, error_2 = '', '', ''
-
-    if gen_hypo_1 and gen_hypo_2:
-        test_result = {
-            'gen_hypo': last_agent_finish_action.thought
-            if last_agent_finish_action
-            else last_agent_message_action.content,
-            'gen_workflow': '',
-            'error': '',
-        }
-        return test_result
-
-    test_result = {
-        'gen_hypo': gen_hypo_1 if gen_hypo_1 else gen_hypo_2,
-        'gen_workflow': gen_workflow_1 if gen_workflow_1 else gen_workflow_2,
-        'error': error_1 if error_1 else error_2,
-    }
-
-    return test_result
-
-
-def process_instance(
-    instance: pd.Series,
-    metadata: EvalMetadata,
-    reset_logger: bool = True,
-):
-    """
-    Process and evaluate a single instance of the dataset.
-
-    This function executes the OpenHands agent
-    for a specific instance of the dataset. It retrieves
-    the agent's results and evaluates them against the gold
-    hypothesis.
-
-    Args:
-        instance: A single row of the dataset
-        metadata: Metadata for the evaluation
-        reset_logger: Whether to reset the logger
-
-    Returns:
-        output: EvalOutput object
-    """
-
-    config = get_config(metadata)
-
-    # Setup the logger properly, so you can run
-    # multi-processing to parallelize the evaluation
-    if reset_logger:
-        log_dir = os.path.join(metadata.eval_output_dir, 'infer_logs')
-        reset_logger_for_multiprocessing(logger, instance.instance_id, log_dir)
-    else:
-        logger.info(f'Starting evaluation for instance {instance.instance_id}.')
-
-    problem_statement, dataset_metadata = get_dv_query_for_real(
-        datasets=instance.datasets,
-        question=instance.query,
-        domain_knowledge=instance.domain_knowledge,
-        workflow_tags=instance.workflow_tags,
-    )
-
-    # Prepare instruction
-    instruction = (
-        f'You are a discovery agent who can execute a python code only once to answer a query based on one or more datasets. The datasets will be present in the current directory.\n\n'
-        'Environment has been set up for you to start working. You may assume all necessary tools and datasets are installed.\n\n'
-        '# Problem Statement\n'
-        f'{problem_statement}\n\n'
-    )
-    instruction += (
-        'IMPORTANT: You should ONLY interact with the environment provided to you AND NEVER ASK FOR HUMAN HELP.\n'
-        'You should NOT modify any existing test case files. If needed, you can add new test cases in a NEW file to reproduce the issue.\n'
-        'You SHOULD INCLUDE PROPER INDENTATION in your edit commands.\n'
-    )
-    # NOTE: You can actually set slightly different instruction for different agents
-    instruction += AGENT_CLS_TO_INST_SUFFIX[metadata.agent_class]
-
-    # Here's how you can run the agent (similar to the `main` function) and get the final task state
-    runtime = create_runtime(config)
-    call_async_from_sync(runtime.connect)
-    initialize_runtime(runtime, instance.data_files)
-
-    state: State | None = asyncio.run(
-        run_controller(
-            config=config,
-            initial_user_action=MessageAction(content=instruction),
-            runtime=runtime,
-            fake_user_response_fn=AGENT_CLS_TO_FAKE_USER_RESPONSE_FN.get(
-                metadata.agent_class
-            ),
-        )
-    )
-
-    if state is None:
-        raise ValueError('State should not be None.')
-
-    metrics = state.metrics.get() if state.metrics else None
-    test_result = complete_runtime(state)
-
-    # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
-    # for compatibility with the existing output format, we can remake the pairs here
-    # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
-
-    # DiscoveryBench Evaluation
-    eval_rec = run_eval_gold_vs_gen_NL_hypo_workflow(
-        query=instance.query,
-        gold_hypo=instance.gold_hypo,
-        gold_workflow='',
-        gen_hypo=test_result['gen_hypo'],
-        gen_workflow='',
-        dataset_meta=instance.dataset_metadata,
-        llm_used=EVALUATION_LLM,
-        dataset_type='real',
-    )
-
-    test_result['eval_rec'] = eval_rec
-
-    output = EvalOutput(
-        instance_id=str(instance.instance_id),
-        instruction=instruction,
-        metadata=metadata,
-        history=histories,
-        metrics=metrics,
-        error=state.last_error if state and state.last_error else None,
-        test_result=test_result,
-    )
-
-    return output
-
-
-def update_csv_name(name):
-    name = name.replace('-', '_')
-
-    if 'meta_regression' in name:
-        name = name.replace('meta_regression', 'meta-regression')
-    if 'ML_enabled' in name:
-        name = name.replace('ML_enabled', 'ML-enabled')
-
-    return name
-
-
-def list_csv_files(list_of_datasets):
-    res = []
-    for ele in list_of_datasets:
-        for key, value in ele.items():
-            if key == 'name':
-                csv_file_name = update_csv_name(value)
-                res.append(DATA_FILES[csv_file_name])
-    return res
-
-
-def create_dataset(repo_location: str, split: str = 'test'):
-    """
-    Create a dataset from the discoverybench repository
-    by walking through the repository and extracting metadata
-    from the metadata_{}.json files
-
-    Args:
-        repo_location: Location of the repository
-        split: Split of the dataset to use
-
-    Returns:
-        df: DataFrame containing the dataset instances
-    """
-
-    data_dict = {}
-
-    data_location = os.path.join(repo_location, 'discoverybench', 'real', split)
-    answer_key_location = os.path.join(repo_location, 'eval', 'answer_key_real.csv')
-
-    idx = 0
-
-    for root, dirs, files in os.walk(data_location):
-        for file in files:
-            if file.endswith('.json'):
-                if 'metadata' in file:
-                    metadata = json.load(open(os.path.join(root, file)))
-
-                    dataset = root.split('/')[-1]
-                    metadata_id = file.split('_')[-1].split('.')[0]
-                    domain = metadata.get('domain', '')
-                    domain_knowledge = metadata.get('domain_knowledge', '')
-                    workflow_tags = metadata.get('workflow_tags', '')
-                    datasets = metadata.get('datasets', [])
-                    queries = metadata.get('queries', [])
-                    gold_workflow = metadata.get('workflow')
-
-                    # loop through queries list to get queries
-                    # and each query has qid; add that to dictionary
-                    for query in queries[0]:
-                        qid = query.get('qid', '')
-
-                        data = {
-                            'dataset': dataset,
-                            'metadata_id': metadata_id,
-                            'qid': qid,
-                            'domain': domain,
-                            'domain_knowledge': domain_knowledge,
-                            'workflow_tags': workflow_tags,
-                            'datasets': datasets,
-                            'question_type': query['question_type'],
-                            'query': query['question'],
-                            'gold_workflow': gold_workflow,
-                            'dataset_metadata': metadata,
-                        }
-
-                        data_dict[idx] = data
-                        idx += 1
-
-            if file.endswith('.csv'):
-                DATA_FILES[file] = os.path.join(root, file)
-            if file.endswith('.txt'):
-                DATA_FILES[file] = os.path.join(root, file)
-
-    df = pd.DataFrame.from_dict(data_dict, orient='index')
-
-    df['instance_id'] = df.index
-
-    df['data_files'] = df['datasets'].apply(lambda x: list_csv_files(x))
-
-    answer_key = pd.read_csv(answer_key_location)
-
-    answer_key = answer_key.rename(
-        columns={
-            'metadataid': 'metadata_id',
-            'query_id': 'qid',
-            'gold_hypothesis': 'gold_hypothesis',
-        }
-    )
-
-    df['qid'] = df['qid'].astype(int)
-    df['metadata_id'] = df['metadata_id'].astype(int)
-
-    answer_key['qid'] = answer_key['qid'].astype(int)
-    answer_key['metadata_id'] = answer_key['metadata_id'].astype(int)
-
-    df = pd.merge(df, answer_key, on=['dataset', 'metadata_id', 'qid'], how='left')
-
-    return df
-
-
-if __name__ == '__main__':
-    args = parse_arguments()
-
-    # clone git repositor for csv files
-    repo_url = 'https://github.com/allenai/discoverybench.git'
-    repo_location = 'git-discoverybench-allenai'
-
-    try:
-        git.Repo.clone_from(repo_url, repo_location)
-    except git.exc.GitCommandError:
-        print('Repository already exists')
-
-    dataset = create_dataset(repo_location)
-
-    # check if there is any empty csv_file
-    if dataset['data_files'].isnull().any():
-        raise ValueError('Some csv files are missing.')
-
-    llm_config = None
-    if args.llm_config:
-        llm_config = get_llm_config_arg(args.llm_config)
-    if llm_config is None:
-        raise ValueError(f'Could not find LLM config: --llm_config {args.llm_config}')
-
-    metadata = make_metadata(
-        llm_config,
-        'discoverybench-python',
-        args.agent_cls,
-        args.max_iterations,
-        args.eval_note,
-        args.eval_output_dir,
-    )
-    output_file = os.path.join(metadata.eval_output_dir, 'output.jsonl')
-    instances = prepare_dataset(dataset, output_file, args.eval_n_limit)
-
-    run_evaluation(
-        instances,
-        metadata,
-        output_file,
-        args.eval_num_workers,
-        process_instance,
-    )

evaluation/discoverybench/scripts/run_infer.sh

@@ -1,46 +0,0 @@
-#!/bin/bash
-set -eo pipefail
-
-source "evaluation/utils/version_control.sh"
-
-MODEL_CONFIG=$1
-COMMIT_HASH=$2
-AGENT=$3
-EVAL_LIMIT=$4
-NUM_WORKERS=$5
-
-if [ -z "$NUM_WORKERS" ]; then
-  NUM_WORKERS=1
-  echo "Number of workers not specified, use default $NUM_WORKERS"
-fi
-
-# ################################################################################
-
-checkout_eval_branch
-
-if [ -z "$AGENT" ]; then
-  echo "Agent not specified, use default CodeActAgent"
-  AGENT="CodeActAgent"
-fi
-
-get_agent_version
-
-echo "AGENT: $AGENT"
-echo "AGENT_VERSION: $AGENT_VERSION"
-echo "MODEL_CONFIG: $MODEL_CONFIG"
-
-COMMAND="poetry run python evaluation/discoverybench/run_infer.py \
-  --agent-cls $AGENT \
-  --llm-config $MODEL_CONFIG \
-  --max-iterations 10 \
-  --max-chars 10000000 \
-  --eval-num-workers $NUM_WORKERS \
-  --eval-note $AGENT_VERSION"
-
-if [ -n "$EVAL_LIMIT" ]; then
-  echo "EVAL_LIMIT: $EVAL_LIMIT"
-  COMMAND="$COMMAND --eval-n-limit $EVAL_LIMIT"
-fi
-
-# Run the command
-eval $COMMAND

evaluation/gaia/run_infer.py

@@ -12,7 +12,6 @@ from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
     codeact_user_response,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -167,7 +166,7 @@ def process_instance(
 
     model_answer_raw = ''
     # get the last message or thought from the agent
-    for event in reversed(state.history):
+    for event in state.history.get_events(reverse=True):
         if event.source == 'agent':
             if isinstance(event, AgentFinishAction):
                 model_answer_raw = event.thought
@@ -204,7 +203,7 @@ def process_instance(
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     # Save the output
     output = EvalOutput(

evaluation/gorilla/run_infer.py

@@ -10,7 +10,6 @@ from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
     codeact_user_response,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -33,7 +32,7 @@ AGENT_CLS_TO_FAKE_USER_RESPONSE_FN = {
 }
 
 AGENT_CLS_TO_INST_SUFFIX = {
-    'CodeActAgent': 'When you think you have completed the request, please finish the interaction using the "finish" tool.\n'
+    'CodeActAgent': 'When you think you have completed the request, please run the following command: <execute_bash> exit </execute_bash>.\n'
 }
 
 
@@ -102,8 +101,7 @@ def process_instance(
         raise ValueError('State should not be None.')
 
     # retrieve the last message from the agent
-    last_agent_message = state.get_last_agent_message()
-    model_answer_raw = last_agent_message.content if last_agent_message else ''
+    model_answer_raw = state.history.get_last_agent_message()
 
     # attempt to parse model_answer
     ast_eval_fn = instance['ast_eval']
@@ -116,7 +114,7 @@ def process_instance(
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     output = EvalOutput(
         instance_id=instance_id,

evaluation/gpqa/run_infer.py

@@ -28,7 +28,6 @@ from datasets import load_dataset
 from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -87,10 +86,11 @@ def gpqa_codeact_user_response(
     msg = (
         'Please continue working on the task on whatever approach you think is suitable.\n'
         'Feel free to use all tools for calculations and solving the problem, and web-search for finding relevant facts during the process if needed\n'
-        'If you have finished reporting the answer in the expected format, (and only once that is done), please use the "finish" tool to finish the interaction.\n'
+        'If you have finished reporting the answer in the expected format, (and only once that is done), please run the following command to submit: <execute_bash> exit </execute_bash>.\n'
         'Again you are being told a million times to first report the answer in the requested format (see again below for reference) before exiting. DO NOT EXIT WITHOUT REPORTING THE ANSWER FIRST.\n'
         'That is, when you have decided on the answer report in the following format:\n'
         f'{ACTION_FORMAT}\n'
+        '<execute_bash> exit </execute_bash>\n'
         'IMPORTANT: YOU SHOULD NEVER ASK FOR HUMAN HELP TO SOLVE THIS TASK.\n'
     )
     return msg
@@ -99,7 +99,7 @@ def gpqa_codeact_user_response(
 AGENT_CLS_TO_FAKE_USER_RESPONSE_FN = {'CodeActAgent': gpqa_codeact_user_response}
 
 AGENT_CLS_TO_INST_SUFFIX = {
-    'CodeActAgent': '\n\n SUPER IMPORTANT: When you think you have solved the question, first report it back to the user in the requested format. Only once that is done, in the next turn, please finish the interaction using the "finish" tool.\n'
+    'CodeActAgent': '\n\n SUPER IMPORTANT: When you think you have solved the question, first report it back to the user in the requested format. Only once that is done, in the next turn, please run the following command: <execute_bash> exit </execute_bash>.\n'
 }
 
 
@@ -204,11 +204,12 @@ Additional Instructions:
 - Do not try to solve the question in a single step. Break it down into smaller steps.
 - You should ONLY interact with the environment provided to you AND NEVER ASK FOR HUMAN HELP.
 
-- SUPER IMPORTANT: When you have reported the answer to the user in the requested format, (and only once that is done) in the next turn, please finish the interaction using the "finish" tool.
+- SUPER IMPORTANT: When you have reported the answer to the user in the requested format, (and only once that is done) in the next turn, please run the following command: <execute_bash> exit </execute_bash>.
 - Again you are being told a million times to first report the answer in the requested format (see again below for reference) before exiting. DO NOT EXIT WITHOUT REPORTING THE ANSWER FIRST.
     That is, when you have decided on the answer report in the following format:
 
 {ACTION_FORMAT}
+<execute_bash> exit </execute_bash>
 
 Again do not quit without reporting the answer first.
 Ok now its time to start solving the question. Good luck!
@@ -243,7 +244,7 @@ Ok now its time to start solving the question. Good luck!
         'C': False,
         'D': False,
     }
-    for event in reversed(state.history):
+    for event in state.history.get_events(reverse=True):
         if (
             isinstance(event, AgentFinishAction)
             and event.source != 'user'
@@ -299,7 +300,7 @@ Ok now its time to start solving the question. Good luck!
         instance_id=str(instance.instance_id),
         instruction=instruction,
         metadata=metadata,
-        history=compatibility_for_eval_history_pairs(state.history),
+        history=state.history.compatibility_for_eval_history_pairs(),
         metrics=metrics,
         error=state.last_error if state and state.last_error else None,
         test_result={

evaluation/humanevalfix/README.md

@@ -23,7 +23,7 @@ For each problem, OpenHands is given a set number of iterations to fix the faili
 ```
 {
     "task_id": "Python/2",
-    "instruction": "Please fix the function in Python__2.py such that all test cases pass.\nEnvironment has been set up for you to start working. You may assume all necessary tools are installed.\n\n# Problem Statement\ndef truncate_number(number: float) -> float:\n    return number % 1.0 + 1.0\n\n\n\n\n\n\ndef check(truncate_number):\n    assert truncate_number(3.5) == 0.5\n    assert abs(truncate_number(1.33) - 0.33) < 1e-6\n    assert abs(truncate_number(123.456) - 0.456) < 1e-6\n\ncheck(truncate_number)\n\nIMPORTANT: You should ONLY interact with the environment provided to you AND NEVER ASK FOR HUMAN HELP.\nYou should NOT modify any existing test case files. If needed, you can add new test cases in a NEW file to reproduce the issue.\nYou SHOULD INCLUDE PROPER INDENTATION in your edit commands.\nWhen you think you have fixed the issue through code changes, please finish the interaction using the "finish" tool.\n",
+    "instruction": "Please fix the function in Python__2.py such that all test cases pass.\nEnvironment has been set up for you to start working. You may assume all necessary tools are installed.\n\n# Problem Statement\ndef truncate_number(number: float) -> float:\n    return number % 1.0 + 1.0\n\n\n\n\n\n\ndef check(truncate_number):\n    assert truncate_number(3.5) == 0.5\n    assert abs(truncate_number(1.33) - 0.33) < 1e-6\n    assert abs(truncate_number(123.456) - 0.456) < 1e-6\n\ncheck(truncate_number)\n\nIMPORTANT: You should ONLY interact with the environment provided to you AND NEVER ASK FOR HUMAN HELP.\nYou should NOT modify any existing test case files. If needed, you can add new test cases in a NEW file to reproduce the issue.\nYou SHOULD INCLUDE PROPER INDENTATION in your edit commands.\nWhen you think you have fixed the issue through code changes, please run the following command: <execute_bash> exit </execute_bash>.\n",
     "metadata": {
         "agent_class": "CodeActAgent",
         "model_name": "gpt-4",
@@ -38,10 +38,10 @@ For each problem, OpenHands is given a set number of iterations to fix the faili
                 "id": 27,
                 "timestamp": "2024-05-22T20:57:24.688651",
                 "source": "user",
-                "message": "Please fix the function in Python__2.py such that all test cases pass.\nEnvironment has been set up for you to start working. You may assume all necessary tools are installed.\n\n# Problem Statement\ndef truncate_number(number: float) -> float:\n    return number % 1.0 + 1.0\n\n\n\n\n\n\ndef check(truncate_number):\n    assert truncate_number(3.5) == 0.5\n    assert abs(truncate_number(1.33) - 0.33) < 1e-6\n    assert abs(truncate_number(123.456) - 0.456) < 1e-6\n\ncheck(truncate_number)\n\nIMPORTANT: You should ONLY interact with the environment provided to you AND NEVER ASK FOR HUMAN HELP.\nYou should NOT modify any existing test case files. If needed, you can add new test cases in a NEW file to reproduce the issue.\nYou SHOULD INCLUDE PROPER INDENTATION in your edit commands.\nWhen you think you have fixed the issue through code changes, please finish the interaction using the "finish" tool.\n",
+                "message": "Please fix the function in Python__2.py such that all test cases pass.\nEnvironment has been set up for you to start working. You may assume all necessary tools are installed.\n\n# Problem Statement\ndef truncate_number(number: float) -> float:\n    return number % 1.0 + 1.0\n\n\n\n\n\n\ndef check(truncate_number):\n    assert truncate_number(3.5) == 0.5\n    assert abs(truncate_number(1.33) - 0.33) < 1e-6\n    assert abs(truncate_number(123.456) - 0.456) < 1e-6\n\ncheck(truncate_number)\n\nIMPORTANT: You should ONLY interact with the environment provided to you AND NEVER ASK FOR HUMAN HELP.\nYou should NOT modify any existing test case files. If needed, you can add new test cases in a NEW file to reproduce the issue.\nYou SHOULD INCLUDE PROPER INDENTATION in your edit commands.\nWhen you think you have fixed the issue through code changes, please run the following command: <execute_bash> exit </execute_bash>.\n",
                 "action": "message",
                 "args": {
-                    "content": "Please fix the function in Python__2.py such that all test cases pass.\nEnvironment has been set up for you to start working. You may assume all necessary tools are installed.\n\n# Problem Statement\ndef truncate_number(number: float) -> float:\n    return number % 1.0 + 1.0\n\n\n\n\n\n\ndef check(truncate_number):\n    assert truncate_number(3.5) == 0.5\n    assert abs(truncate_number(1.33) - 0.33) < 1e-6\n    assert abs(truncate_number(123.456) - 0.456) < 1e-6\n\ncheck(truncate_number)\n\nIMPORTANT: You should ONLY interact with the environment provided to you AND NEVER ASK FOR HUMAN HELP.\nYou should NOT modify any existing test case files. If needed, you can add new test cases in a NEW file to reproduce the issue.\nYou SHOULD INCLUDE PROPER INDENTATION in your edit commands.\nWhen you think you have fixed the issue through code changes, please finish the interaction using the "finish" tool.\n",
+                    "content": "Please fix the function in Python__2.py such that all test cases pass.\nEnvironment has been set up for you to start working. You may assume all necessary tools are installed.\n\n# Problem Statement\ndef truncate_number(number: float) -> float:\n    return number % 1.0 + 1.0\n\n\n\n\n\n\ndef check(truncate_number):\n    assert truncate_number(3.5) == 0.5\n    assert abs(truncate_number(1.33) - 0.33) < 1e-6\n    assert abs(truncate_number(123.456) - 0.456) < 1e-6\n\ncheck(truncate_number)\n\nIMPORTANT: You should ONLY interact with the environment provided to you AND NEVER ASK FOR HUMAN HELP.\nYou should NOT modify any existing test case files. If needed, you can add new test cases in a NEW file to reproduce the issue.\nYou SHOULD INCLUDE PROPER INDENTATION in your edit commands.\nWhen you think you have fixed the issue through code changes, please run the following command: <execute_bash> exit </execute_bash>.\n",
                     "wait_for_response": false
                 }
             },

evaluation/humanevalfix/run_infer.py

@@ -21,7 +21,6 @@ from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
     codeact_user_response,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -75,7 +74,7 @@ AGENT_CLS_TO_FAKE_USER_RESPONSE_FN = {
 }
 
 AGENT_CLS_TO_INST_SUFFIX = {
-    'CodeActAgent': 'When you think you have fixed the issue through code changes, please finish the interaction using the "finish" tool.\n'
+    'CodeActAgent': 'When you think you have fixed the issue through code changes, please run the following command: <execute_bash> exit </execute_bash>.\n'
 }
 
 
@@ -256,7 +255,7 @@ def process_instance(
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     # Save the output
     output = EvalOutput(

evaluation/integration_tests/run_infer.py

@@ -13,7 +13,6 @@ from evaluation.utils.shared import (
     prepare_dataset,
     reset_logger_for_multiprocessing,
     run_evaluation,
-    update_llm_config_for_completions_logging,
 )
 from openhands.controller.state.state import State
 from openhands.core.config import (
@@ -56,14 +55,18 @@ def get_config(
         workspace_base=None,
         workspace_mount_path=None,
     )
-    config.set_llm_config(
-        update_llm_config_for_completions_logging(
-            metadata.llm_config, metadata.eval_output_dir, instance_id
+    if metadata.llm_config.log_completions:
+        metadata.llm_config.log_completions_folder = os.path.join(
+            metadata.eval_output_dir, 'llm_completions', instance_id
         )
-    )
+        logger.info(
+            f'Logging LLM completions for instance {instance_id} to '
+            f'{metadata.llm_config.log_completions_folder}'
+        )
+    config.set_llm_config(metadata.llm_config)
     agent_config = AgentConfig(
         codeact_enable_jupyter=True,
-        codeact_enable_browsing=True,
+        codeact_enable_browsing_delegate=True,
         codeact_enable_llm_editor=False,
     )
     config.set_agent_config(agent_config)
@@ -129,7 +132,7 @@ def process_instance(
     # # result evaluation
     # # =============================================
 
-    histories = [event_to_dict(event) for event in state.history]
+    histories = [event_to_dict(event) for event in state.history.get_events()]
     test_result: TestResult = test_class.verify_result(runtime, histories)
     metrics = state.metrics.get() if state.metrics else None
 

evaluation/integration_tests/tests/t06_github_pr_browsing.py

@@ -1,44 +0,0 @@
-from evaluation.integration_tests.tests.base import BaseIntegrationTest, TestResult
-from openhands.events.action import AgentFinishAction, MessageAction
-from openhands.events.event import Event
-from openhands.events.observation import AgentDelegateObservation
-from openhands.runtime.base import Runtime
-
-
-class Test(BaseIntegrationTest):
-    INSTRUCTION = 'Look at https://github.com/All-Hands-AI/OpenHands/pull/8, and tell me what is happening there and what did @asadm suggest.'
-
-    @classmethod
-    def initialize_runtime(cls, runtime: Runtime) -> None:
-        pass
-
-    @classmethod
-    def verify_result(cls, runtime: Runtime, histories: list[Event]) -> TestResult:
-        # check if the "The answer is OpenHands is all you need!" is in any message
-        message_actions = [
-            event
-            for event in histories
-            if isinstance(
-                event, (MessageAction, AgentFinishAction, AgentDelegateObservation)
-            )
-        ]
-        for event in message_actions:
-            if isinstance(event, AgentDelegateObservation):
-                content = event.content
-            elif isinstance(event, AgentFinishAction):
-                content = event.outputs.get('content', '')
-            elif isinstance(event, MessageAction):
-                content = event.content
-            else:
-                raise ValueError(f'Unknown event type: {type(event)}')
-
-            if (
-                'non-commercial' in content
-                or 'MIT' in content
-                or 'Apache 2.0' in content
-            ):
-                return TestResult(success=True)
-        return TestResult(
-            success=False,
-            reason=f'The answer is not found in any message. Total messages: {len(message_actions)}. Messages: {message_actions}',
-        )

evaluation/logic_reasoning/run_infer.py

@@ -8,7 +8,6 @@ from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
     codeact_user_response,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -226,7 +225,7 @@ def process_instance(
         raise ValueError('State should not be None.')
 
     final_message = ''
-    for event in reversed(state.history):
+    for event in state.history.get_events(reverse=True):
         if isinstance(event, AgentFinishAction):
             final_message = event.thought
             break
@@ -248,7 +247,7 @@ def process_instance(
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     # Save the output
     output = EvalOutput(

evaluation/miniwob/README.md

@@ -16,20 +16,6 @@ Access with browser the above MiniWoB URLs and see if they load correctly.
 ./evaluation/miniwob/scripts/run_infer.sh llm.claude-35-sonnet-eval
 ```
 
-### Run Inference on `RemoteRuntime` (experimental)
-
-This is in limited beta. Contact Xingyao over slack if you want to try this out!
-
-```bash
-./evaluation/miniwob/scripts/run_infer.sh [model_config] [git-version] [agent] [note] [eval_limit] [num_workers]
-
-# Example - This runs evaluation on BrowsingAgent for 125 instances on miniwob, with 2 workers running in parallel
-export ALLHANDS_API_KEY="YOUR-API-KEY"
-export RUNTIME=remote
-export SANDBOX_REMOTE_RUNTIME_API_URL="https://runtime.eval.all-hands.dev"
-./evaluation/miniwob/scripts/run_infer.sh llm.eval HEAD BrowsingAgent "" 125 2
-```
-
 Results will be in `evaluation/evaluation_outputs/outputs/miniwob/`
 
 To calculate the average reward, run:

evaluation/miniwob/get_avg_reward.py

@@ -23,7 +23,7 @@ if __name__ == '__main__':
             data = json.loads(line)
             actual_num += 1
             total_cost += data['metrics']['accumulated_cost']
-            total_reward += data['test_result']['reward']
+            total_reward += data['test_result']
 
     avg_reward = total_reward / total_num
     print('Avg Reward: ', avg_reward)

evaluation/miniwob/run_infer.py

@@ -10,13 +10,10 @@ import pandas as pd
 from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
-    codeact_user_response,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
     run_evaluation,
-    update_llm_config_for_completions_logging,
 )
 from openhands.controller.state.state import State
 from openhands.core.config import (
@@ -32,10 +29,7 @@ from openhands.events.action import (
     CmdRunAction,
     MessageAction,
 )
-from openhands.events.observation import (
-    BrowserOutputObservation,
-    CmdOutputObservation,
-)
+from openhands.events.observation import CmdOutputObservation
 from openhands.runtime.base import Runtime
 from openhands.runtime.browser.browser_env import (
     BROWSER_EVAL_GET_GOAL_ACTION,
@@ -43,12 +37,7 @@ from openhands.runtime.browser.browser_env import (
 )
 from openhands.utils.async_utils import call_async_from_sync
 
-SUPPORTED_AGENT_CLS = {'BrowsingAgent', 'CodeActAgent'}
-
-AGENT_CLS_TO_FAKE_USER_RESPONSE_FN = {
-    'CodeActAgent': codeact_user_response,
-    'BrowsingAgent': 'Continue the task. IMPORTANT: do not talk to the user until you have finished the task',
-}
+SUPPORTED_AGENT_CLS = {'BrowsingAgent'}
 
 
 def get_config(
@@ -58,34 +47,25 @@ def get_config(
     config = AppConfig(
         default_agent=metadata.agent_class,
         run_as_openhands=False,
-        runtime=os.environ.get('RUNTIME', 'eventstream'),
+        runtime='eventstream',
         max_iterations=metadata.max_iterations,
         sandbox=SandboxConfig(
             base_container_image='xingyaoww/od-eval-miniwob:v1.0',
             enable_auto_lint=True,
             use_host_network=False,
             browsergym_eval_env=env_id,
-            api_key=os.environ.get('ALLHANDS_API_KEY', None),
-            remote_runtime_api_url=os.environ.get('SANDBOX_REMOTE_RUNTIME_API_URL'),
-            remote_runtime_init_timeout=1800,
-            keep_runtime_alive=False,
-            timeout=120,
         ),
         # do not mount workspace
         workspace_base=None,
         workspace_mount_path=None,
     )
-    config.set_llm_config(
-        update_llm_config_for_completions_logging(
-            metadata.llm_config, metadata.eval_output_dir, env_id
-        )
-    )
+    config.set_llm_config(metadata.llm_config)
     return config
 
 
 def initialize_runtime(
     runtime: Runtime,
-) -> tuple[str, BrowserOutputObservation]:
+) -> str:
     """Initialize the runtime for the agent.
 
     This function is called before the runtime is used to run the agent.
@@ -105,14 +85,8 @@ def initialize_runtime(
     logger.info(obs, extra={'msg_type': 'OBSERVATION'})
     goal = obs.content
 
-    # Run noop to get the initial browser observation (e.g., the page URL & content)
-    action = BrowseInteractiveAction(browser_actions='noop(1000)')
-    logger.info(action, extra={'msg_type': 'ACTION'})
-    obs = runtime.run_action(action)
-    logger.info(obs, extra={'msg_type': 'OBSERVATION'})
-
     logger.info(f"{'-' * 50} END Runtime Initialization Fn {'-' * 50}")
-    return goal, obs
+    return goal
 
 
 def complete_runtime(
@@ -143,7 +117,7 @@ def process_instance(
     metadata: EvalMetadata,
     reset_logger: bool = True,
 ) -> EvalOutput:
-    env_id = instance.instance_id
+    env_id = instance.id
     config = get_config(metadata, env_id)
 
     # Setup the logger properly, so you can run multi-processing to parallelize the evaluation
@@ -155,12 +129,7 @@ def process_instance(
 
     runtime = create_runtime(config)
     call_async_from_sync(runtime.connect)
-    task_str, obs = initialize_runtime(runtime)
-
-    task_str += (
-        f'\nInitial browser state (output of `noop(1000)`):\n{obs.get_agent_obs_text()}'
-    )
-
+    task_str = initialize_runtime(runtime)
     state: State | None = asyncio.run(
         run_controller(
             config=config,
@@ -168,9 +137,6 @@ def process_instance(
                 content=task_str
             ),  # take output from initialize_runtime
             runtime=runtime,
-            fake_user_response_fn=AGENT_CLS_TO_FAKE_USER_RESPONSE_FN[
-                metadata.agent_class
-            ],
         )
     )
 
@@ -186,19 +152,19 @@ def process_instance(
 
     # Instruction is the first message from the USER
     instruction = ''
-    for event in state.history:
+    for event in state.history.get_events():
         if isinstance(event, MessageAction):
             instruction = event.content
             break
 
     return_val = complete_runtime(runtime)
     logger.info(f'Return value from complete_runtime: {return_val}')
-    reward = max(return_val['rewards'], default=0)
+    reward = max(return_val['rewards'])
 
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     # Save the output
     output = EvalOutput(

evaluation/miniwob/scripts/run_infer.sh

@@ -33,7 +33,7 @@ echo "MODEL_CONFIG: $MODEL_CONFIG"
 
 EVAL_NOTE="${AGENT_VERSION}_${NOTE}"
 
-COMMAND="export PYTHONPATH=evaluation/miniwob:\$PYTHONPATH && poetry run python evaluation/miniwob/run_infer.py \
+COMMAND="poetry run python evaluation/miniwob/run_infer.py \
   --agent-cls $AGENT \
   --llm-config $MODEL_CONFIG \
   --max-iterations 10 \

evaluation/mint/run_infer.py

@@ -13,7 +13,6 @@ from evaluation.mint.tasks import Task
 from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -29,7 +28,6 @@ from openhands.core.config import (
 from openhands.core.logger import openhands_logger as logger
 from openhands.core.main import create_runtime, run_controller
 from openhands.events.action import (
-    Action,
     CmdRunAction,
     MessageAction,
 )
@@ -47,10 +45,7 @@ def codeact_user_response_mint(state: State, task: Task, task_config: dict[str,
         task=task,
         task_config=task_config,
     )
-    last_action = next(
-        (event for event in reversed(state.history) if isinstance(event, Action)),
-        None,
-    )
+    last_action = state.history.get_last_action()
     result_state: TaskState = env.step(last_action.message or '')
 
     state.extra_data['task_state'] = result_state
@@ -70,7 +65,7 @@ AGENT_CLS_TO_FAKE_USER_RESPONSE_FN = {
 }
 
 AGENT_CLS_TO_INST_SUFFIX = {
-    'CodeActAgent': 'IMPORTANT: When your answer is confirmed by the user to be correct, you can use the "finish" tool to finish the interaction.\n'
+    'CodeActAgent': '\nIMPORTANT: When your answer is confirmed by the user to be correct, you can exit using the following command: <execute_bash> exit </execute_bash>.\n'
 }
 
 with open(os.path.join(os.path.dirname(__file__), 'requirements.txt'), 'r') as f:
@@ -207,7 +202,7 @@ def process_instance(
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     # Save the output
     output = EvalOutput(

evaluation/ml_bench/README.md

@@ -55,7 +55,7 @@ Here's an example of the evaluation output for a single task instance:
 {
   "instance_id": 3,
   "repo": "https://github.com/dmlc/dgl",
-  "instruction": "Please complete the Machine Learning task in the following repository: dgl\n\nThe task is: DGL Implementation of NGCF model\n\nI have a deep desire to embark on a journey brimming with knowledge and expertise. My objective is to train a cutting-edge NGCF Model, known for its unparalleled capabilities, on the illustrious dataset known as gowalla. To ensure swift execution, I kindly request your assistance in crafting the code, making use of the powerful GPU #3 and an embedding size of 32. Can you lend a helping hand to transform this dream into a reality?\n\nYou should create a script named `run.sh` under the specified path in the repo to run the task.\n\nYou can find the task repo at: /workspace/dgl/examples/pytorch/NGCF/NGCF\n\nYou should terminate the subprocess after running the task (e.g., call subprocess.Popen(args).wait()).When you think you have completed the task, please finish the interaction using the "finish" tool.\n",
+  "instruction": "Please complete the Machine Learning task in the following repository: dgl\n\nThe task is: DGL Implementation of NGCF model\n\nI have a deep desire to embark on a journey brimming with knowledge and expertise. My objective is to train a cutting-edge NGCF Model, known for its unparalleled capabilities, on the illustrious dataset known as gowalla. To ensure swift execution, I kindly request your assistance in crafting the code, making use of the powerful GPU #3 and an embedding size of 32. Can you lend a helping hand to transform this dream into a reality?\n\nYou should create a script named `run.sh` under the specified path in the repo to run the task.\n\nYou can find the task repo at: /workspace/dgl/examples/pytorch/NGCF/NGCF\n\nYou should terminate the subprocess after running the task (e.g., call subprocess.Popen(args).wait()).When you think you have completed the task, please run the following command: <execute_bash> exit </execute_bash>.\n",
   "metadata": {
     "agent_class": "CodeActAgent",
     "model_name": "gpt-4-1106-preview",
@@ -70,10 +70,10 @@ Here's an example of the evaluation output for a single task instance:
         "id": 0,
         "timestamp": "2024-05-26T17:40:41.060009",
         "source": "user",
-        "message": "Please complete the Machine Learning task in the following repository: dgl\n\nThe task is: DGL Implementation of NGCF model\n\nI have a deep desire to embark on a journey brimming with knowledge and expertise. My objective is to train a cutting-edge NGCF Model, known for its unparalleled capabilities, on the illustrious dataset known as gowalla. To ensure swift execution, I kindly request your assistance in crafting the code, making use of the powerful GPU #3 and an embedding size of 32. Can you lend a helping hand to transform this dream into a reality?\n\nYou should create a script named `run.sh` under the specified path in the repo to run the task.\n\nYou can find the task repo at: /workspace/dgl/examples/pytorch/NGCF/NGCF\n\nYou should terminate the subprocess after running the task (e.g., call subprocess.Popen(args).wait()).When you think you have completed the task, please finish the interaction using the "finish" tool.\n",
+        "message": "Please complete the Machine Learning task in the following repository: dgl\n\nThe task is: DGL Implementation of NGCF model\n\nI have a deep desire to embark on a journey brimming with knowledge and expertise. My objective is to train a cutting-edge NGCF Model, known for its unparalleled capabilities, on the illustrious dataset known as gowalla. To ensure swift execution, I kindly request your assistance in crafting the code, making use of the powerful GPU #3 and an embedding size of 32. Can you lend a helping hand to transform this dream into a reality?\n\nYou should create a script named `run.sh` under the specified path in the repo to run the task.\n\nYou can find the task repo at: /workspace/dgl/examples/pytorch/NGCF/NGCF\n\nYou should terminate the subprocess after running the task (e.g., call subprocess.Popen(args).wait()).When you think you have completed the task, please run the following command: <execute_bash> exit </execute_bash>.\n",
         "action": "message",
         "args": {
-          "content": "Please complete the Machine Learning task in the following repository: dgl\n\nThe task is: DGL Implementation of NGCF model\n\nI have a deep desire to embark on a journey brimming with knowledge and expertise. My objective is to train a cutting-edge NGCF Model, known for its unparalleled capabilities, on the illustrious dataset known as gowalla. To ensure swift execution, I kindly request your assistance in crafting the code, making use of the powerful GPU #3 and an embedding size of 32. Can you lend a helping hand to transform this dream into a reality?\n\nYou should create a script named `run.sh` under the specified path in the repo to run the task.\n\nYou can find the task repo at: /workspace/dgl/examples/pytorch/NGCF/NGCF\n\nYou should terminate the subprocess after running the task (e.g., call subprocess.Popen(args).wait()).When you think you have completed the task, please finish the interaction using the "finish" tool.\n",
+          "content": "Please complete the Machine Learning task in the following repository: dgl\n\nThe task is: DGL Implementation of NGCF model\n\nI have a deep desire to embark on a journey brimming with knowledge and expertise. My objective is to train a cutting-edge NGCF Model, known for its unparalleled capabilities, on the illustrious dataset known as gowalla. To ensure swift execution, I kindly request your assistance in crafting the code, making use of the powerful GPU #3 and an embedding size of 32. Can you lend a helping hand to transform this dream into a reality?\n\nYou should create a script named `run.sh` under the specified path in the repo to run the task.\n\nYou can find the task repo at: /workspace/dgl/examples/pytorch/NGCF/NGCF\n\nYou should terminate the subprocess after running the task (e.g., call subprocess.Popen(args).wait()).When you think you have completed the task, please run the following command: <execute_bash> exit </execute_bash>.\n",
           "wait_for_response": false
         }
       },

evaluation/ml_bench/run_infer.py

@@ -24,7 +24,6 @@ from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
     codeact_user_response,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -52,7 +51,7 @@ AGENT_CLS_TO_FAKE_USER_RESPONSE_FN = {
 }
 
 AGENT_CLS_TO_INST_SUFFIX = {
-    'CodeActAgent': 'When you think you have completed the task, please finish the interaction using the "finish" tool.\n'
+    'CodeActAgent': 'When you think you have completed the task, please run the following command: <execute_bash> exit </execute_bash>.\n'
 }
 
 ID2CONDA = {
@@ -257,7 +256,7 @@ def process_instance(instance: Any, metadata: EvalMetadata, reset_logger: bool =
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     # Save the output
     output = EvalOutput(

evaluation/scienceagentbench/Dockerfile

@@ -1,17 +0,0 @@
-FROM python:3.11-bookworm
-
-
-# For OpenHands agents to explore the dataset directories, please download the full benchmark [here](https://buckeyemailosu-my.sharepoint.com/:u:/g/personal/chen_8336_buckeyemail_osu_edu/EQuA6uJ3CtRHvRfZ2GiN1tYBRVJE4DSUD10MW61fr7HuSQ?e=sCBegG) and unzip it with password `scienceagentbench`.
-# **Please DO NOT redistribute the unzipped data files online.**
-# It will download a benchmark.zip file to the current directory.
-# unzip it and put the benchmark folder under evaluation/scienceagentbench/
-
-RUN mkdir -p /benchmark
-COPY benchmark /benchmark
-
-RUN mkdir -p /workspace
-WORKDIR /workspace
-
-# pushd evaluation/scienceagentbench
-# docker build -t xingyaoww/openhands-eval-scienceagentbench .
-# popd

evaluation/scienceagentbench/Dockerfile.evaluator

@@ -1,25 +0,0 @@
-FROM mambaorg/micromamba:debian12
-
-USER root
-# For https://github.com/OSU-NLP-Group/ScienceAgentBench/tree/main?tab=readme-ov-file#code-generation-with-agents
-
-RUN micromamba create -n sci-agent-eval python=3.10 pip setuptools wheel
-RUN micromamba run -n sci-agent-eval pip install pip-tools
-
-RUN mkdir -p /workspace
-WORKDIR /workspace
-
-RUN apt-get update && apt-get install -y git
-
-RUN git clone https://github.com/OSU-NLP-Group/ScienceAgentBench.git /workspace/
-RUN git checkout 4eddc7db6449a5ade3e37285747c8b208cd54ce7
-
-RUN micromamba create -n sci-agent python=3.10 pip setuptools wheel
-RUN micromamba run -n sci-agent pip install -r requirements.txt
-
-# Replace all occurence of conda with micromamba under the /workspace
-RUN find ./ -type f -exec sed -i 's/conda/micromamba/g' {} \;
-
-# pushd evaluation/scienceagentbench
-# docker build -t xingyaoww/openhands-eval-scienceagentbench-evaluator -f Dockerfile.evaluator .
-# popd

evaluation/scienceagentbench/README.md

@@ -1,54 +0,0 @@
-# ScienceAgentBench Evaluation with OpenHands
-
-This folder contains the evaluation harness for [ScienceAgentBench](https://osu-nlp-group.github.io/ScienceAgentBench/) (paper: https://arxiv.org/abs/2410.05080).
-
-## Setup Environment and LLM Configuration
-
-Please follow instruction [here](../README.md#setup) to setup your local development environment and LLM.
-
-## Setup ScienceAgentBench
-
-To prevent benchmark data contamination, we only provide the annotation sheet on [Huggingface](https://huggingface.co/datasets/osunlp/ScienceAgentBench), which includes all necessary *inputs* to run an agent.
-
-## Run Inference on ScienceAgentBench
-
-```bash
-./evaluation/scienceagentbench/scripts/run_infer.sh [model_config] [git-version] [use_knowledge] [agent] [eval_limit] [max_iter] [num_workers] [dataset] [dataset_split]
-
-# Example
-./evaluation/scienceagentbench/scripts/run_infer.sh llm.eval_gpt4o 0.9.3
-```
-
-where `model_config` is mandatory, and the rest are optional.
-
-- `model_config`, e.g. `eval_gpt4_1106_preview`, is the config group name for your
-LLM settings, as defined in your `config.toml`.
-- `git-version`, e.g. `HEAD`, is the git commit hash of the OpenHands version you would
-like to evaluate. It could also be a release tag like `0.6.2`.
-- `use_knowledge`, e.g. `true`, specifies whether allowing the agent to use expert-provided knowledge as additional input or not. By default, it is set to `false`.
-- `agent`, e.g. `CodeActAgent`, is the name of the agent for benchmarks, defaulting
-to `CodeActAgent`.
-- `eval_limit`, e.g. `10`, limits the evaluation to the first `eval_limit` instances. By
-default, the script evaluates the entire SWE-bench_Lite test set (300 issues). Note:
-in order to use `eval_limit`, you must also set `agent`.
-- `max_iter`, e.g. `20`, is the maximum number of iterations for the agent to run. By
-default, it is set to 30.
-- `num_workers`, e.g. `3`, is the number of parallel workers to run the evaluation. By
-default, it is set to 1.
-
-## Evaluate Generated Programs
-
-### Extract Necessary Information from OpenHands Log
-
-After the inference is completed, you may use the following command to extract necessary information from the output log for evaluation:
-
-```bash
-python post_proc.py [log_fname]
-```
-- `log_fname`, e.g. `evaluation/.../output.jsonl`, is the automatically saved trajectory log of an OpenHands agent.
-
-Output will be write to e.g. `evaluation/.../output.converted.jsonl`
-
-### Run evaluation
-
-Please follow the steps [here](https://github.com/OSU-NLP-Group/ScienceAgentBench/tree/main?tab=readme-ov-file#evaluation-of-generated-code) to evaluate the generated programs.

evaluation/scienceagentbench/post_proc.py

@@ -1,30 +0,0 @@
-import json
-from argparse import ArgumentParser
-
-if __name__ == '__main__':
-    parser = ArgumentParser()
-    parser.add_argument(
-        'log_fname',
-        type=str,
-    )
-    args = parser.parse_args()
-
-    fname = args.log_fname
-    out_fname = args.log_fname.replace('.jsonl', '.converted.jsonl')
-
-    log = [json.loads(line) for line in open(fname)]
-
-    simple_log = [
-        json.dumps(
-            {
-                'instance_id': ex['instance_id'],
-                'instruction': ex['instruction'],
-                'test_result': ex['test_result'],
-                'cost': ex['metrics']['accumulated_cost'],
-            }
-        )
-        for ex in log
-    ]
-
-    with open(out_fname, 'w+', encoding='utf-8') as f:
-        f.write('\n'.join(simple_log))

evaluation/scienceagentbench/run_infer.py

@@ -1,292 +0,0 @@
-import asyncio
-import os
-from typing import Any
-
-import pandas as pd
-from datasets import load_dataset
-from tqdm import tqdm
-
-from evaluation.utils.shared import (
-    EvalMetadata,
-    EvalOutput,
-    codeact_user_response,
-    compatibility_for_eval_history_pairs,
-    make_metadata,
-    prepare_dataset,
-    reset_logger_for_multiprocessing,
-    run_evaluation,
-    update_llm_config_for_completions_logging,
-)
-from openhands.controller.state.state import State
-from openhands.core.config import (
-    AppConfig,
-    SandboxConfig,
-    get_llm_config_arg,
-    get_parser,
-)
-from openhands.core.logger import openhands_logger as logger
-from openhands.core.main import create_runtime, run_controller
-from openhands.events.action import CmdRunAction, MessageAction
-from openhands.events.observation import CmdOutputObservation
-from openhands.runtime.base import Runtime
-from openhands.utils.async_utils import call_async_from_sync
-
-AGENT_CLS_TO_FAKE_USER_RESPONSE_FN = {
-    'CodeActAgent': codeact_user_response,
-}
-
-LOCAL_DATASET_PATH = os.path.join(os.path.dirname(__file__), 'benchmark')
-
-
-def format_task_dict(example, use_knowledge):
-    task = {
-        'instance_id': example['instance_id'],
-        'task_inst': example['task_inst'],
-        'dataset_path': '/benchmark/datasets/'
-        + example['dataset_folder_tree'].split('\n')[0][4:],
-        'dataset_folder_tree': example['dataset_folder_tree'],
-        'dataset_preview': example['dataset_preview'],
-        'pred_program_name': 'pred_' + example['gold_program_name'],
-    }
-
-    if use_knowledge:
-        task['task_inst'] += '\n' + str(example['domain_knowledge'])
-
-    return task
-
-
-def get_config(
-    metadata: EvalMetadata,
-    instance_id: str,
-) -> AppConfig:
-    config = AppConfig(
-        default_agent=metadata.agent_class,
-        run_as_openhands=False,
-        runtime=os.environ.get('RUNTIME', 'eventstream'),
-        max_budget_per_task=4,
-        max_iterations=metadata.max_iterations,
-        sandbox=SandboxConfig(
-            base_container_image='docker.io/xingyaoww/openhands-eval-scienceagentbench',
-            enable_auto_lint=True,
-            use_host_network=False,
-            timeout=300,
-            api_key=os.environ.get('ALLHANDS_API_KEY', None),
-            remote_runtime_api_url=os.environ.get('SANDBOX_REMOTE_RUNTIME_API_URL'),
-            keep_runtime_alive=False,
-        ),
-        # do not mount workspace
-        workspace_base=None,
-        workspace_mount_path=None,
-    )
-    config.set_llm_config(
-        update_llm_config_for_completions_logging(
-            metadata.llm_config,
-            metadata.eval_output_dir,
-            instance_id,
-        )
-    )
-    return config
-
-
-def initialize_runtime(
-    runtime: Runtime,
-    instance: pd.Series,  # this argument is not required
-):
-    """Initialize the runtime for the agent.
-
-    This function is called before the runtime is used to run the agent.
-    """
-    logger.info(f"{'-' * 50} BEGIN Runtime Initialization Fn {'-' * 50}")
-    obs: CmdOutputObservation
-
-    # Set up workspace directories
-    action = CmdRunAction(command='mkdir -p /workspace/pred_programs')
-    logger.info(action, extra={'msg_type': 'ACTION'})
-    obs = runtime.run_action(action)
-    assert obs.exit_code == 0
-
-    action = CmdRunAction(command='mkdir -p /workspace/pred_results')
-    logger.info(action, extra={'msg_type': 'ACTION'})
-    obs = runtime.run_action(action)
-    assert obs.exit_code == 0
-
-    dataset_name = instance['dataset_folder_tree'].split('\n')[0][4:].rstrip('/')
-
-    # Copy the dataset to the workspace
-    dataset_dir = os.path.join(
-        LOCAL_DATASET_PATH,
-        'datasets',
-        dataset_name,
-    )
-    runtime.copy_to(dataset_dir, '/workspace/benchmark/datasets', recursive=True)
-
-    # Check the dataset exists
-    action = CmdRunAction(
-        command='cd /workspace/benchmark/datasets && ls',
-        keep_prompt=False,
-    )
-    obs = runtime.run_action(action)
-    logger.info(obs, extra={'msg_type': 'OBSERVATION'})
-    assert obs.exit_code == 0
-    assert dataset_name in obs.content
-
-    logger.info(f"{'-' * 50} END Runtime Initialization Fn {'-' * 50}")
-
-
-def complete_runtime(
-    runtime: Runtime,
-    instance: pd.Series,
-) -> dict[str, Any]:
-    """Complete the runtime for the agent.
-
-    This function is called before the runtime is used to run the agent.
-    If you need to do something in the sandbox to get the correctness metric after
-    the agent has run, modify this function.
-    """
-    logger.info(f"{'-' * 50} BEGIN Runtime Completion Fn {'-' * 50}")
-    obs: CmdOutputObservation
-
-    test_result = {}
-
-    action = CmdRunAction(command='cd /workspace')
-    logger.info(action, extra={'msg_type': 'ACTION'})
-    obs = runtime.run_action(action)
-
-    assert obs.exit_code == 0
-
-    action = CmdRunAction(
-        command=f'cat pred_programs/{instance.pred_program_name}',
-        keep_prompt=False,
-    )
-    logger.info(action, extra={'msg_type': 'ACTION'})
-    obs = runtime.run_action(action)
-
-    if obs.exit_code == 0:
-        test_result = {'program': obs.content}
-    else:
-        test_result = {'program': 'ERROR'}
-
-    logger.info(f"{'-' * 50} END Runtime Completion Fn {'-' * 50}")
-    return test_result
-
-
-def process_instance(
-    instance: pd.Series,
-    metadata: EvalMetadata,
-    reset_logger: bool = True,
-) -> EvalOutput:
-    instance_id = instance.instance_id.replace('/', '__')
-    config = get_config(metadata, instance_id)
-
-    # Set up the logger properly, so you can run multi-processing to parallelize the evaluation
-    if reset_logger:
-        log_dir = os.path.join(metadata.eval_output_dir, 'infer_logs')
-        reset_logger_for_multiprocessing(logger, instance_id, log_dir)
-    else:
-        logger.info(f'Starting evaluation for instance {instance_id}.')
-
-    instruction = f"""You are an expert Python programming assistant that helps scientist users to write high-quality code to solve their tasks.
-Given a user request, you are expected to write a complete program that accomplishes the requested task and save any outputs to `/workspace/pred_results/` in the correct format.
-
-Here's the user request you need to work on:
-{instance.task_inst}
-
-You can access the dataset at `{instance.dataset_path}`. Here is the directory structure of the dataset:
-```
-{instance.dataset_folder_tree}
-```
-Here are some helpful previews for the dataset file(s):
-{instance.dataset_preview}
-
-Please save your program as `/workspace/pred_programs/{instance.pred_program_name}`.
-Then, please run the program to check and fix any errors.
-Please do NOT run the program in the background.
-If the program uses some packages that are incompatible, please figure out alternative implementations and do NOT restart the environment.
-
-"""
-
-    runtime = create_runtime(config)
-    call_async_from_sync(runtime.connect)
-    initialize_runtime(runtime, instance)
-
-    # Here's how you can run the agent (similar to the `main` function) and get the final task state
-    state: State | None = asyncio.run(
-        run_controller(
-            config=config,
-            initial_user_action=MessageAction(content=instruction),
-            runtime=runtime,
-            fake_user_response_fn=AGENT_CLS_TO_FAKE_USER_RESPONSE_FN.get(
-                metadata.agent_class
-            ),
-        )
-    )
-
-    # ======= Attempt to evaluate the agent's edits =======
-    test_result = complete_runtime(runtime, instance)
-
-    # If you are working on some simpler benchmark that only evaluates the final model output (e.g., in a MessageAction)
-    # You can simply get the LAST `MessageAction` from the returned `state.history` and parse it for evaluation.
-    if state is None:
-        raise ValueError('State should not be None.')
-    metrics = state.metrics.get() if state.metrics else None
-
-    # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
-    # for compatibility with the existing output format, we can remake the pairs here
-    # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
-
-    # Save the output
-    output = EvalOutput(
-        instance_id=instance.instance_id,
-        instruction=instruction,
-        metadata=metadata,
-        history=histories,
-        metrics=metrics,
-        error=state.last_error if state and state.last_error else None,
-        test_result=test_result,
-    )
-    return output
-
-
-if __name__ == '__main__':
-    parser = get_parser()
-    parser.add_argument(
-        '--use_knowledge',
-        type=str,
-        default='false',
-        choices=['true', 'false'],
-        help='use expert-provided knowledge or not',
-    )
-    args, _ = parser.parse_known_args()
-
-    sab_dataset = load_dataset('osunlp/ScienceAgentBench', split='validation')
-
-    dataset_processed = []
-    for example in tqdm(sab_dataset):
-        dataset_processed.append(
-            format_task_dict(example, args.use_knowledge == 'true')
-        )
-
-    dataset = pd.DataFrame(dataset_processed)
-
-    llm_config = None
-    if args.llm_config:
-        llm_config = get_llm_config_arg(args.llm_config)
-    if llm_config is None:
-        raise ValueError(f'Could not find LLM config: --llm_config {args.llm_config}')
-
-    metadata = make_metadata(
-        llm_config,
-        'ScienceAgentBench',
-        args.agent_cls,
-        args.max_iterations,
-        args.eval_note,
-        args.eval_output_dir,
-    )
-    output_file = os.path.join(metadata.eval_output_dir, 'output.jsonl')
-    dataset['instance_id'] = dataset['instance_id'].apply(str)
-    instances = prepare_dataset(dataset, output_file, args.eval_n_limit)
-
-    run_evaluation(
-        instances, metadata, output_file, args.eval_num_workers, process_instance
-    )

evaluation/scienceagentbench/scripts/run_infer.sh

@@ -1,49 +0,0 @@
-#!/bin/bash
-set -eo pipefail
-
-source "evaluation/utils/version_control.sh"
-
-MODEL_CONFIG=$1
-COMMIT_HASH=$2
-USE_KNOWLEDGE=$3
-AGENT=$4
-EVAL_LIMIT=$5
-NUM_WORKERS=$6
-
-if [ -z "$NUM_WORKERS" ]; then
-  NUM_WORKERS=1
-  echo "Number of workers not specified, use default $NUM_WORKERS"
-fi
-checkout_eval_branch
-
-if [ -z "$AGENT" ]; then
-  echo "Agent not specified, use default CodeActAgent"
-  AGENT="CodeActAgent"
-fi
-
-if [ -z "$USE_KNOWLEDGE" ]; then
-  echo "Use knowledge not specified, use default False"
-  USE_KNOWLEDGE=false
-fi
-
-get_agent_version
-
-echo "AGENT: $AGENT"
-echo "AGENT_VERSION: $AGENT_VERSION"
-echo "MODEL_CONFIG: $MODEL_CONFIG"
-
-COMMAND="poetry run python evaluation/scienceagentbench/run_infer.py \
-  --agent-cls $AGENT \
-  --llm-config $MODEL_CONFIG \
-  --use_knowledge $USE_KNOWLEDGE \
-  --max-iterations 30 \
-  --eval-num-workers $NUM_WORKERS \
-  --eval-note $AGENT_VERSION" \
-
-if [ -n "$EVAL_LIMIT" ]; then
-  echo "EVAL_LIMIT: $EVAL_LIMIT"
-  COMMAND="$COMMAND --eval-n-limit $EVAL_LIMIT"
-fi
-
-# Run the command
-eval $COMMAND

evaluation/swe_bench/eval_infer.py

@@ -1,7 +1,6 @@
 import os
 import tempfile
 import time
-from functools import partial
 
 import pandas as pd
 from swebench.harness.grading import get_eval_report
@@ -84,7 +83,6 @@ def get_config(instance: pd.Series) -> AppConfig:
             timeout=1800,
             api_key=os.environ.get('ALLHANDS_API_KEY', None),
             remote_runtime_api_url=os.environ.get('SANDBOX_REMOTE_RUNTIME_API_URL'),
-            remote_runtime_init_timeout=3600,
         ),
         # do not mount workspace
         workspace_base=None,
@@ -95,28 +93,13 @@ def get_config(instance: pd.Series) -> AppConfig:
 
 def process_instance(
     instance: pd.Series,
-    metadata: EvalMetadata,
+    metadata: EvalMetadata | None = None,
     reset_logger: bool = True,
-    log_dir: str | None = None,
 ) -> EvalOutput:
-    """
-    Evaluate agent performance on a SWE-bench problem instance.
-
-    Note that this signature differs from the expected input to `run_evaluation`. Use
-    `functools.partial` to provide optional arguments before passing to the evaluation harness.
-
-    Args:
-        log_dir (str | None, default=None): Path to directory where log files will be written. Must
-        be provided if `reset_logger` is set.
-
-    Raises:
-        AssertionError: if the `reset_logger` flag is set without a provided log directory.
-    """
     # Setup the logger properly, so you can run multi-processing to parallelize the evaluation
     if reset_logger:
-        assert (
-            log_dir is not None
-        ), "Can't reset logger without a provided log directory."
+        global output_file
+        log_dir = output_file.replace('.jsonl', '.logs')
         os.makedirs(log_dir, exist_ok=True)
         reset_logger_for_multiprocessing(logger, instance.instance_id, log_dir)
     else:
@@ -143,7 +126,6 @@ def process_instance(
         return EvalOutput(
             instance_id=instance_id,
             test_result=instance['test_result'],
-            metadata=metadata,
         )
 
     runtime = create_runtime(config)
@@ -193,7 +175,6 @@ def process_instance(
             return EvalOutput(
                 instance_id=instance_id,
                 test_result=instance['test_result'],
-                metadata=metadata,
             )
         elif 'APPLY_PATCH_PASS' in apply_patch_output:
             logger.info(f'[{instance_id}] {APPLY_PATCH_PASS}:\n{apply_patch_output}')
@@ -258,34 +239,28 @@ def process_instance(
                         # Create a directory structure that matches the expected format
                         # NOTE: this is a hack to make the eval report format consistent
                         # with the original SWE-Bench eval script
-                        log_dir = os.path.join(temp_dir, 'logs', instance_id.lower())
+                        log_dir = os.path.join(temp_dir, 'logs', instance_id)
                         os.makedirs(log_dir, exist_ok=True)
                         test_output_path = os.path.join(log_dir, 'test_output.txt')
                         with open(test_output_path, 'w') as f:
                             f.write(test_output)
-                        try:
-                            _report = get_eval_report(
-                                test_spec=test_spec,
-                                prediction={
-                                    'model_patch': model_patch,
-                                    'instance_id': instance_id,
-                                },
-                                log_path=test_output_path,
-                                include_tests_status=True,
-                            )
-                            report = _report[instance_id]
-                            logger.info(
-                                f"[{instance_id}] report: {report}\nResult for {instance_id}: resolved: {report['resolved']}"
-                            )
-                            instance['test_result']['report']['resolved'] = report[
-                                'resolved'
-                            ]
-                        except Exception as e:
-                            logger.error(
-                                f'[{instance_id}] Error when getting eval report: {e}'
-                            )
-                            instance['test_result']['report']['resolved'] = False
-                            instance['test_result']['report']['error_eval'] = True
+
+                        _report = get_eval_report(
+                            test_spec=test_spec,
+                            prediction={
+                                'model_patch': model_patch,
+                                'instance_id': instance_id,
+                            },
+                            log_path=test_output_path,
+                            include_tests_status=True,
+                        )
+                        report = _report[instance_id]
+                        logger.info(
+                            f"[{instance_id}] report: {report}\nResult for {instance_id}: resolved: {report['resolved']}"
+                        )
+                        instance['test_result']['report']['resolved'] = report[
+                            'resolved'
+                        ]
             else:
                 logger.info(f'[{instance_id}] Error when starting eval:\n{obs.content}')
                 instance['test_result']['report']['error_eval'] = True
@@ -293,7 +268,6 @@ def process_instance(
             return EvalOutput(
                 instance_id=instance_id,
                 test_result=instance['test_result'],
-                metadata=metadata,
             )
         else:
             logger.info(
@@ -361,7 +335,7 @@ if __name__ == '__main__':
 
     if 'model_patch' not in predictions.columns:
         predictions['model_patch'] = predictions['test_result'].apply(
-            lambda x: x.get('git_patch', '')
+            lambda x: x['git_patch']
         )
     assert {'instance_id', 'model_patch'}.issubset(
         set(predictions.columns)
@@ -380,26 +354,12 @@ if __name__ == '__main__':
     output_file = args.input_file.replace('.jsonl', '.swebench_eval.jsonl')
     instances = prepare_dataset(predictions, output_file, args.eval_n_limit)
 
-    # If possible, load the relevant metadata to avoid issues with `run_evaluation`.
-    metadata: EvalMetadata | None = None
-    metadata_filepath = os.path.join(os.path.dirname(args.input_file), 'metadata.json')
-    if os.path.exists(metadata_filepath):
-        with open(metadata_filepath, 'r') as metadata_file:
-            data = metadata_file.read()
-            metadata = EvalMetadata.model_validate_json(data)
-
-    # The evaluation harness constrains the signature of `process_instance_func` but we need to
-    # pass extra information. Build a new function object to avoid issues with multiprocessing.
-    process_instance_func = partial(
-        process_instance, log_dir=output_file.replace('.jsonl', '.logs')
-    )
-
     run_evaluation(
         instances,
-        metadata=metadata,
+        metadata=None,
         output_file=output_file,
         num_workers=args.eval_num_workers,
-        process_instance_func=process_instance_func,
+        process_instance_func=process_instance,
     )
 
     # Load evaluated predictions & print number of resolved predictions

evaluation/swe_bench/prompt.py

@@ -1,6 +1,6 @@
 CODEACT_SWE_PROMPT = """Now, you're going to solve this issue on your own. Your terminal session has started and you're in the repository's root directory. You can use any bash commands or the special interface to help you. Edit all the files you need to and run any checks or tests that you want.
 Remember, YOU CAN ONLY ENTER ONE COMMAND AT A TIME. You should always wait for feedback after every command.
-When you're satisfied with all of the changes you've made, you can use the "finish" tool to finish the interaction.
+When you're satisfied with all of the changes you've made, you can run the following command: <execute_bash> exit </execute_bash>.
 Note however that you cannot use any interactive session commands (e.g. vim) in this environment, but you can write scripts and run them. E.g. you can write a python script and then run it with `python <script_name>.py`.
 
 NOTE ABOUT THE EDIT COMMAND: Indentation really matters! When editing a file, make sure to insert appropriate indentation before each line!

evaluation/swe_bench/run_infer.py

@@ -20,7 +20,6 @@ from evaluation.utils.shared import (
     prepare_dataset,
     reset_logger_for_multiprocessing,
     run_evaluation,
-    update_llm_config_for_completions_logging,
 )
 from openhands.controller.state.state import State
 from openhands.core.config import (
@@ -36,12 +35,11 @@ from openhands.events.action import CmdRunAction, MessageAction
 from openhands.events.observation import CmdOutputObservation, ErrorObservation
 from openhands.events.serialization.event import event_to_dict
 from openhands.runtime.base import Runtime
+from openhands.runtime.utils.shutdown_listener import sleep_if_should_continue
 from openhands.utils.async_utils import call_async_from_sync
-from openhands.utils.shutdown_listener import sleep_if_should_continue
 
 USE_HINT_TEXT = os.environ.get('USE_HINT_TEXT', 'false').lower() == 'true'
 USE_INSTANCE_IMAGE = os.environ.get('USE_INSTANCE_IMAGE', 'false').lower() == 'true'
-RUN_WITH_BROWSING = os.environ.get('RUN_WITH_BROWSING', 'false').lower() == 'true'
 
 AGENT_CLS_TO_FAKE_USER_RESPONSE_FN = {
     'CodeActAgent': codeact_user_response,
@@ -81,7 +79,7 @@ def get_instruction(instance: pd.Series, metadata: EvalMetadata):
             '</pr_description>\n\n'
             'Can you help me implement the necessary changes to the repository so that the requirements specified in the <pr_description> are met?\n'
             "I've already taken care of all changes to any of the test files described in the <pr_description>. This means you DON'T have to modify the testing logic or any of the tests in any way!\n"
-            'Your task is to make the minimal changes to non-tests files in the /workspace directory to ensure the <pr_description> is satisfied.\n'
+            'Your task is to make the minimal changes to non-tests files in the /repo directory to ensure the <pr_description> is satisfied.\n'
             'Follow these steps to resolve the issue:\n'
             '1. As a first step, it might be a good idea to explore the repo to familiarize yourself with its structure.\n'
             '2. Create a script to reproduce the error and execute it with `python <filename.py>` using the BashTool, to confirm the error\n'
@@ -90,13 +88,6 @@ def get_instruction(instance: pd.Series, metadata: EvalMetadata):
             '5. Think about edgecases and make sure your fix handles them as well\n'
             "Your thinking should be thorough and so it's fine if it's very long.\n"
         )
-
-    if RUN_WITH_BROWSING:
-        instruction += (
-            '<IMPORTANT!>\n'
-            'You SHOULD NEVER attempt to browse the web. '
-            '</IMPORTANT!>\n'
-        )
     return instruction
 
 
@@ -110,7 +101,7 @@ def get_instance_docker_image(instance_id: str) -> str:
     image_name = image_name.replace(
         '__', '_s_'
     )  # to comply with docker image naming convention
-    return (DOCKER_IMAGE_PREFIX.rstrip('/') + '/' + image_name).lower()
+    return DOCKER_IMAGE_PREFIX.rstrip('/') + '/' + image_name
 
 
 def get_config(
@@ -145,21 +136,24 @@ def get_config(
             platform='linux/amd64',
             api_key=os.environ.get('ALLHANDS_API_KEY', None),
             remote_runtime_api_url=os.environ.get('SANDBOX_REMOTE_RUNTIME_API_URL'),
-            keep_runtime_alive=False,
-            remote_runtime_init_timeout=3600,
+            keep_remote_runtime_alive=False,
         ),
         # do not mount workspace
         workspace_base=None,
         workspace_mount_path=None,
     )
-    config.set_llm_config(
-        update_llm_config_for_completions_logging(
-            metadata.llm_config, metadata.eval_output_dir, instance['instance_id']
+    if metadata.llm_config.log_completions:
+        metadata.llm_config.log_completions_folder = os.path.join(
+            metadata.eval_output_dir, 'llm_completions', instance['instance_id']
         )
-    )
+        logger.info(
+            f'Logging LLM completions for instance {instance["instance_id"]} to '
+            f'{metadata.llm_config.log_completions_folder}'
+        )
+    config.set_llm_config(metadata.llm_config)
     agent_config = AgentConfig(
         codeact_enable_jupyter=False,
-        codeact_enable_browsing=RUN_WITH_BROWSING,
+        codeact_enable_browsing_delegate=False,
         codeact_enable_llm_editor=False,
     )
     config.set_agent_config(agent_config)
@@ -444,8 +438,7 @@ def process_instance(
     if state is None:
         raise ValueError('State should not be None.')
 
-    # NOTE: this is NO LONGER the event stream, but an agent history that includes delegate agent's events
-    histories = [event_to_dict(event) for event in state.history]
+    histories = [event_to_dict(event) for event in state.history.get_events()]
     metrics = state.metrics.get() if state.metrics else None
 
     # Save the output
@@ -534,10 +527,5 @@ if __name__ == '__main__':
             instances[col] = instances[col].apply(lambda x: str(x))
 
     run_evaluation(
-        instances,
-        metadata,
-        output_file,
-        args.eval_num_workers,
-        process_instance,
-        timeout_seconds=120 * 60,  # 2 hour PER instance should be more than enough
+        instances, metadata, output_file, args.eval_num_workers, process_instance
     )

evaluation/swe_bench/scripts/run_infer.sh

@@ -34,11 +34,6 @@ if [ -z "$USE_INSTANCE_IMAGE" ]; then
   USE_INSTANCE_IMAGE=true
 fi
 
-if [ -z "$RUN_WITH_BROWSING" ]; then
-  echo "RUN_WITH_BROWSING not specified, use default false"
-  RUN_WITH_BROWSING=false
-fi
-
 
 if [ -z "$DATASET" ]; then
   echo "DATASET not specified, use default princeton-nlp/SWE-bench_Lite"
@@ -52,8 +47,6 @@ fi
 
 export USE_INSTANCE_IMAGE=$USE_INSTANCE_IMAGE
 echo "USE_INSTANCE_IMAGE: $USE_INSTANCE_IMAGE"
-export RUN_WITH_BROWSING=$RUN_WITH_BROWSING
-echo "RUN_WITH_BROWSING: $RUN_WITH_BROWSING"
 
 get_agent_version
 
@@ -74,10 +67,6 @@ if [ "$USE_HINT_TEXT" = false ]; then
   EVAL_NOTE="$EVAL_NOTE-no-hint"
 fi
 
-if [ "$RUN_WITH_BROWSING" = true ]; then
-  EVAL_NOTE="$EVAL_NOTE-with-browsing"
-fi
-
 if [ -n "$EXP_NAME" ]; then
   EVAL_NOTE="$EVAL_NOTE-$EXP_NAME"
 fi

evaluation/toolqa/run_infer.py

@@ -9,7 +9,6 @@ from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
     codeact_user_response,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -34,7 +33,7 @@ AGENT_CLS_TO_FAKE_USER_RESPONSE_FN = {
 }
 
 AGENT_CLS_TO_INST_SUFFIX = {
-    'CodeActAgent': 'When you think you have completed the request, please finish the interaction using the "finish" tool.\n'
+    'CodeActAgent': 'When you think you have completed the request, please run the following command: <execute_bash> exit </execute_bash>.\n'
 }
 
 
@@ -127,8 +126,7 @@ def process_instance(instance: Any, metadata: EvalMetadata, reset_logger: bool =
         raise ValueError('State should not be None.')
 
     # retrieve the last message from the agent
-    last_agent_message = state.get_last_agent_message()
-    model_answer_raw = last_agent_message.content if last_agent_message else ''
+    model_answer_raw = state.history.get_last_agent_message()
 
     # attempt to parse model_answer
     correct = eval_answer(str(model_answer_raw), str(answer))
@@ -139,7 +137,7 @@ def process_instance(instance: Any, metadata: EvalMetadata, reset_logger: bool =
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     # Save the output
     output = EvalOutput(

evaluation/utils/shared.py

@@ -3,11 +3,9 @@ import logging
 import multiprocessing as mp
 import os
 import pathlib
-import signal
 import subprocess
 import time
 import traceback
-from contextlib import contextmanager
 from typing import Any, Awaitable, Callable, TextIO
 
 import pandas as pd
@@ -20,9 +18,6 @@ from openhands.core.logger import get_console_handler
 from openhands.core.logger import openhands_logger as logger
 from openhands.events.action import Action
 from openhands.events.action.message import MessageAction
-from openhands.events.event import Event
-from openhands.events.serialization.event import event_to_dict
-from openhands.events.utils import get_pairs_from_events
 
 
 class EvalMetadata(BaseModel):
@@ -94,27 +89,6 @@ class EvalException(Exception):
     pass
 
 
-class EvalTimeoutException(Exception):
-    pass
-
-
-@contextmanager
-def timeout(seconds: int):
-    def timeout_handler(signum, frame):
-        raise EvalTimeoutException(f'Function timed out after {seconds} seconds')
-
-    # Set up the signal handler
-    original_handler = signal.signal(signal.SIGALRM, timeout_handler)
-    signal.alarm(seconds)
-
-    try:
-        yield
-    finally:
-        # Restore the original handler and disable the alarm
-        signal.alarm(0)
-        signal.signal(signal.SIGALRM, original_handler)
-
-
 def codeact_user_response(
     state: State,
     encapsulate_solution: bool = False,
@@ -138,14 +112,7 @@ def codeact_user_response(
     if state.history:
         # check if the last action has an answer, if so, early exit
         if try_parse is not None:
-            last_action = next(
-                (
-                    event
-                    for event in reversed(state.history)
-                    if isinstance(event, Action)
-                ),
-                None,
-            )
+            last_action = state.history.get_last_action()
             ans = try_parse(last_action)
             if ans is not None:
                 return '/exit'
@@ -153,14 +120,14 @@ def codeact_user_response(
         # check if the agent has tried to talk to the user 3 times, if so, let the agent know it can give up
         user_msgs = [
             event
-            for event in state.history
+            for event in state.history.get_events()
             if isinstance(event, MessageAction) and event.source == 'user'
         ]
         if len(user_msgs) >= 2:
             # let the agent know that it can give up when it has tried 3 times
             return (
                 msg
-                + 'If you want to give up, use the "finish" tool to finish the interaction.\n'
+                + 'If you want to give up, run: <execute_bash> exit </execute_bash>.\n'
             )
     return msg
 
@@ -303,33 +270,15 @@ def _process_instance_wrapper(
     metadata: EvalMetadata,
     use_mp: bool,
     max_retries: int = 5,
-    timeout_seconds: int | None = None,
 ) -> EvalOutput:
-    """Wrap the process_instance_func to handle retries and errors."""
+    """Wrap the process_instance_func to handle retries and errors.
+
+    Retry an instance up to max_retries times if it fails (e.g., due to transient network/runtime issues).
+    """
     for attempt in range(max_retries + 1):
         try:
-            if timeout_seconds is not None:
-                with timeout(timeout_seconds):
-                    result = process_instance_func(instance, metadata, use_mp)
-            else:
-                result = process_instance_func(instance, metadata, use_mp)
+            result = process_instance_func(instance, metadata, use_mp)
             return result
-        except EvalTimeoutException as e:
-            error = f'Timeout after {timeout_seconds} seconds'
-            stacktrace = traceback.format_exc()
-            msg = (
-                '-' * 10
-                + '\n'
-                + f'Timeout ({timeout_seconds} seconds) in instance [{instance.instance_id}], Stopped evaluation for this instance.'
-                + '\n'
-                + '-' * 10
-            )
-            logger.exception(e)
-            return EvalOutput(
-                instance_id=instance.instance_id,
-                test_result={},
-                error=error,
-            )
         except Exception as e:
             error = str(e)
             stacktrace = traceback.format_exc()
@@ -378,7 +327,6 @@ def run_evaluation(
         [pd.Series, EvalMetadata, bool], Awaitable[EvalOutput]
     ],
     max_retries: int = 5,  # number of retries for each instance
-    timeout_seconds: int | None = None,
 ):
     use_multiprocessing = num_workers > 1
 
@@ -388,7 +336,6 @@ def run_evaluation(
             f'model {metadata.llm_config.model}, max iterations {metadata.max_iterations}.\n'
         )
     else:
-        logger.warning('Running evaluation without metadata.')
         logger.info(f'Evaluation started with {num_workers} workers.')
 
     total_instances = len(dataset)
@@ -399,14 +346,7 @@ def run_evaluation(
         if use_multiprocessing:
             with mp.Pool(num_workers) as pool:
                 args_iter = (
-                    (
-                        process_instance_func,
-                        instance,
-                        metadata,
-                        True,
-                        max_retries,
-                        timeout_seconds,
-                    )
+                    (process_instance_func, instance, metadata, True, max_retries)
                     for _, instance in dataset.iterrows()
                 )
                 results = pool.imap_unordered(_process_instance_wrapper_mp, args_iter)
@@ -471,35 +411,3 @@ def reset_logger_for_multiprocessing(
     )
     file_handler.setLevel(logging.INFO)
     logger.addHandler(file_handler)
-
-
-def update_llm_config_for_completions_logging(
-    llm_config: LLMConfig,
-    eval_output_dir: str,
-    instance_id: str,
-) -> LLMConfig:
-    """Update the LLM config for logging completions."""
-    if llm_config.log_completions:
-        llm_config.log_completions_folder = os.path.join(
-            eval_output_dir, 'llm_completions', instance_id
-        )
-        logger.info(
-            f'Logging LLM completions for instance {instance_id} to '
-            f'{llm_config.log_completions_folder}'
-        )
-    return llm_config
-
-
-# history is now available as a filtered stream of events, rather than list of pairs of (Action, Observation)
-# we rebuild the pairs here
-# for compatibility with the existing output format in evaluations
-# remove this when it's no longer necessary
-def compatibility_for_eval_history_pairs(
-    history: list[Event],
-) -> list[tuple[dict, dict]]:
-    history_pairs = []
-
-    for action, observation in get_pairs_from_events(history):
-        history_pairs.append((event_to_dict(action), event_to_dict(observation)))
-
-    return history_pairs

evaluation/webarena/run_infer.py

@@ -10,7 +10,6 @@ import pandas as pd
 from evaluation.utils.shared import (
     EvalMetadata,
     EvalOutput,
-    compatibility_for_eval_history_pairs,
     make_metadata,
     prepare_dataset,
     reset_logger_for_multiprocessing,
@@ -167,7 +166,7 @@ def process_instance(
 
     # Instruction is the first message from the USER
     instruction = ''
-    for event in state.history:
+    for event in state.history.get_events():
         if isinstance(event, MessageAction):
             instruction = event.content
             break
@@ -179,7 +178,7 @@ def process_instance(
     # history is now available as a stream of events, rather than list of pairs of (Action, Observation)
     # for compatibility with the existing output format, we can remake the pairs here
     # remove when it becomes unnecessary
-    histories = compatibility_for_eval_history_pairs(state.history)
+    histories = state.history.compatibility_for_eval_history_pairs()
 
     # Save the output
     output = EvalOutput(

frontend/.eslintrc

@@ -84,4 +84,4 @@
       }
     }
   ]
-}
+}

frontend/.gitignore

@@ -1,9 +1,4 @@
 # i18n translation files make by script using `make build`
 public/locales/**/*
 src/i18n/declaration.ts
-.env
-node_modules/
-/test-results/
-/playwright-report/
-/blob-report/
-/playwright/.cache/
+.env

frontend/__tests__/clear-session.test.ts

@@ -1,40 +0,0 @@
-import { describe, it, expect, beforeEach, vi } from "vitest";
-import { clearSession } from "../src/utils/clear-session";
-import store from "../src/store";
-import { initialState as browserInitialState } from "../src/state/browserSlice";
-
-describe("clearSession", () => {
-  beforeEach(() => {
-    // Mock localStorage
-    const localStorageMock = {
-      getItem: vi.fn(),
-      setItem: vi.fn(),
-      removeItem: vi.fn(),
-      clear: vi.fn(),
-    };
-    vi.stubGlobal("localStorage", localStorageMock);
-
-    // Set initial browser state to non-default values
-    store.dispatch({
-      type: "browser/setUrl",
-      payload: "https://example.com",
-    });
-    store.dispatch({
-      type: "browser/setScreenshotSrc",
-      payload: "base64screenshot",
-    });
-  });
-
-  it("should clear localStorage and reset browser state", () => {
-    clearSession();
-
-    // Verify localStorage items were removed
-    expect(localStorage.removeItem).toHaveBeenCalledWith("token");
-    expect(localStorage.removeItem).toHaveBeenCalledWith("repo");
-
-    // Verify browser state was reset
-    const state = store.getState();
-    expect(state.browser.url).toBe(browserInitialState.url);
-    expect(state.browser.screenshotSrc).toBe(browserInitialState.screenshotSrc);
-  });
-});

frontend/__tests__/components/chat/chat-input.test.tsx

@@ -1,5 +1,5 @@
 import userEvent from "@testing-library/user-event";
-import { fireEvent, render, screen } from "@testing-library/react";
+import { render, screen } from "@testing-library/react";
 import { describe, afterEach, vi, it, expect } from "vitest";
 import { ChatInput } from "#/components/chat-input";
 
@@ -158,46 +158,4 @@ describe("ChatInput", () => {
     await user.tab();
     expect(onBlurMock).toHaveBeenCalledOnce();
   });
-
-  it("should handle text paste correctly", () => {
-    const onSubmit = vi.fn();
-    const onChange = vi.fn();
-
-    render(<ChatInput onSubmit={onSubmit} onChange={onChange} />);
-
-    const input = screen.getByTestId("chat-input").querySelector("textarea");
-    expect(input).toBeTruthy();
-
-    // Fire paste event with text data
-    fireEvent.paste(input!, {
-      clipboardData: {
-        getData: (type: string) => type === 'text/plain' ? 'test paste' : '',
-        files: []
-      }
-    });
-  });
-
-  it("should handle image paste correctly", () => {
-    const onSubmit = vi.fn();
-    const onImagePaste = vi.fn();
-
-    render(<ChatInput onSubmit={onSubmit} onImagePaste={onImagePaste} />);
-
-    const input = screen.getByTestId("chat-input").querySelector("textarea");
-    expect(input).toBeTruthy();
-
-    // Create a paste event with an image file
-    const file = new File(["dummy content"], "image.png", { type: "image/png" });
-
-    // Fire paste event with image data
-    fireEvent.paste(input!, {
-      clipboardData: {
-        getData: () => '',
-        files: [file]
-      }
-    });
-
-    // Verify image paste was handled
-    expect(onImagePaste).toHaveBeenCalledWith([file]);
-  });
 });

frontend/__tests__/components/chat/chat-interface.test.tsx

@@ -1,162 +1,20 @@
-import { afterEach, beforeAll, describe, expect, it, vi } from "vitest";
-import { act, screen, waitFor, within } from "@testing-library/react";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { render, screen, within } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
-import { renderWithProviders } from "test-utils";
 import { ChatInterface } from "#/components/chat-interface";
-import { addUserMessage } from "#/state/chatSlice";
-import { SUGGESTIONS } from "#/utils/suggestions";
-import * as ChatSlice from "#/state/chatSlice";
+import { SocketProvider } from "#/context/socket";
 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const renderChatInterface = (messages: (Message | ErrorMessage)[]) =>
-  renderWithProviders(<ChatInterface />);
-
-describe("Empty state", () => {
-  const { send: sendMock } = vi.hoisted(() => ({
-    send: vi.fn(),
-  }));
-
-  const { useWsClient: useWsClientMock } = vi.hoisted(() => ({
-    useWsClient: vi.fn(() => ({ send: sendMock, runtimeActive: true })),
-  }));
-
-  beforeAll(() => {
-    vi.mock("@remix-run/react", async (importActual) => ({
-      ...(await importActual<typeof import("@remix-run/react")>()),
-      useRouteLoaderData: vi.fn(() => ({})),
-    }));
-
-    vi.mock("#/context/socket", async (importActual) => ({
-      ...(await importActual<typeof import("#/context/ws-client-provider")>()),
-      useWsClient: useWsClientMock,
-    }));
-  });
-
-  afterEach(() => {
-    vi.clearAllMocks();
-  });
-
-  it("should render suggestions if empty", () => {
-    const { store } = renderWithProviders(<ChatInterface />, {
-      preloadedState: {
-        chat: { messages: [] },
-      },
-    });
-
-    expect(screen.getByTestId("suggestions")).toBeInTheDocument();
-
-    act(() => {
-      store.dispatch(
-        addUserMessage({
-          content: "Hello",
-          imageUrls: [],
-          timestamp: new Date().toISOString(),
-        }),
-      );
-    });
-
-    expect(screen.queryByTestId("suggestions")).not.toBeInTheDocument();
-  });
-
-  it("should render the default suggestions", () => {
-    renderWithProviders(<ChatInterface />, {
-      preloadedState: {
-        chat: { messages: [] },
-      },
-    });
-
-    const suggestions = screen.getByTestId("suggestions");
-    const repoSuggestions = Object.keys(SUGGESTIONS.repo);
-
-    // check that there are at most 4 suggestions displayed
-    const displayedSuggestions = within(suggestions).getAllByRole("button");
-    expect(displayedSuggestions.length).toBeLessThanOrEqual(4);
-
-    // Check that each displayed suggestion is one of the repo suggestions
-    displayedSuggestions.forEach((suggestion) => {
-      expect(repoSuggestions).toContain(suggestion.textContent);
-    });
-  });
-
-  it.fails(
-    "should load the a user message to the input when selecting",
-    async () => {
-      // this is to test that the message is in the UI before the socket is called
-      useWsClientMock.mockImplementation(() => ({
-        send: sendMock,
-        runtimeActive: false, // mock an inactive runtime setup
-      }));
-      const addUserMessageSpy = vi.spyOn(ChatSlice, "addUserMessage");
-      const user = userEvent.setup();
-      const { store } = renderWithProviders(<ChatInterface />, {
-        preloadedState: {
-          chat: { messages: [] },
-        },
-      });
-
-      const suggestions = screen.getByTestId("suggestions");
-      const displayedSuggestions = within(suggestions).getAllByRole("button");
-      const input = screen.getByTestId("chat-input");
-
-      await user.click(displayedSuggestions[0]);
-
-      // user message loaded to input
-      expect(addUserMessageSpy).not.toHaveBeenCalled();
-      expect(screen.queryByTestId("suggestions")).toBeInTheDocument();
-      expect(store.getState().chat.messages).toHaveLength(0);
-      expect(input).toHaveValue(displayedSuggestions[0].textContent);
-    },
-  );
-
-  it.fails(
-    "should send the message to the socket only if the runtime is active",
-    async () => {
-      useWsClientMock.mockImplementation(() => ({
-        send: sendMock,
-        runtimeActive: false, // mock an inactive runtime setup
-      }));
-      const user = userEvent.setup();
-      const { rerender } = renderWithProviders(<ChatInterface />, {
-        preloadedState: {
-          chat: { messages: [] },
-        },
-      });
-
-      const suggestions = screen.getByTestId("suggestions");
-      const displayedSuggestions = within(suggestions).getAllByRole("button");
-
-      await user.click(displayedSuggestions[0]);
-      expect(sendMock).not.toHaveBeenCalled();
-
-      useWsClientMock.mockImplementation(() => ({
-        send: sendMock,
-        runtimeActive: true, // mock an active runtime setup
-      }));
-      rerender(<ChatInterface />);
-
-      await waitFor(() =>
-        expect(sendMock).toHaveBeenCalledWith(expect.any(String)),
-      );
-    },
-  );
-});
+  render(<ChatInterface />, { wrapper: SocketProvider });
 
 describe.skip("ChatInterface", () => {
-  beforeAll(() => {
-    // mock useScrollToBottom hook
-    vi.mock("#/hooks/useScrollToBottom", () => ({
-      useScrollToBottom: vi.fn(() => ({
-        scrollDomToBottom: vi.fn(),
-        onChatBodyScroll: vi.fn(),
-        hitBottom: vi.fn(),
-      })),
-    }));
-  });
-
   afterEach(() => {
     vi.clearAllMocks();
   });
 
+  it.todo("should render suggestions if empty");
+
   it("should render messages", () => {
     const messages: Message[] = [
       {
@@ -270,14 +128,14 @@ describe.skip("ChatInterface", () => {
         timestamp: new Date().toISOString(),
       },
       {
-        error: true,
-        id: "",
+        error: "Woops!",
         message: "Something went wrong",
       },
     ];
     renderChatInterface(messages);
 
     const error = screen.getByTestId("error-message");
+    expect(within(error).getByText("Woops!")).toBeInTheDocument();
     expect(within(error).getByText("Something went wrong")).toBeInTheDocument();
   });
 

frontend/__tests__/components/feedback-form.test.tsx

@@ -5,6 +5,7 @@ import { FeedbackForm } from "#/components/feedback-form";
 
 describe("FeedbackForm", () => {
   const user = userEvent.setup();
+  const onSubmitMock = vi.fn();
   const onCloseMock = vi.fn();
 
   afterEach(() => {
@@ -12,7 +13,7 @@ describe("FeedbackForm", () => {
   });
 
   it("should render correctly", () => {
-    render(<FeedbackForm polarity="positive" onClose={onCloseMock} />);
+    render(<FeedbackForm onSubmit={onSubmitMock} onClose={onCloseMock} />);
 
     screen.getByLabelText("Email");
     screen.getByLabelText("Private");
@@ -23,7 +24,7 @@ describe("FeedbackForm", () => {
   });
 
   it("should switch between private and public permissions", async () => {
-    render(<FeedbackForm polarity="positive" onClose={onCloseMock} />);
+    render(<FeedbackForm onSubmit={onSubmitMock} onClose={onCloseMock} />);
     const privateRadio = screen.getByLabelText("Private");
     const publicRadio = screen.getByLabelText("Public");
 
@@ -39,11 +40,69 @@ describe("FeedbackForm", () => {
     expect(publicRadio).not.toBeChecked();
   });
 
+  it("should call onSubmit when the form is submitted", async () => {
+    render(<FeedbackForm onSubmit={onSubmitMock} onClose={onCloseMock} />);
+    const email = screen.getByLabelText("Email");
+
+    await user.type(email, "test@test.test");
+    await user.click(screen.getByRole("button", { name: "Submit" }));
+
+    expect(onSubmitMock).toHaveBeenCalledWith("private", "test@test.test"); // private is the default value
+  });
+
+  it("should not call onSubmit when the email is invalid", async () => {
+    render(<FeedbackForm onSubmit={onSubmitMock} onClose={onCloseMock} />);
+    const email = screen.getByLabelText("Email");
+    const submitButton = screen.getByRole("button", { name: "Submit" });
+
+    await user.click(submitButton);
+
+    expect(onSubmitMock).not.toHaveBeenCalled();
+
+    await user.type(email, "test");
+    await user.click(submitButton);
+
+    expect(onSubmitMock).not.toHaveBeenCalled();
+  });
+
+  it("should submit public permissions when the public radio is checked", async () => {
+    render(<FeedbackForm onSubmit={onSubmitMock} onClose={onCloseMock} />);
+    const email = screen.getByLabelText("Email");
+    const publicRadio = screen.getByLabelText("Public");
+
+    await user.type(email, "test@test.test");
+    await user.click(publicRadio);
+    await user.click(screen.getByRole("button", { name: "Submit" }));
+
+    expect(onSubmitMock).toHaveBeenCalledWith("public", "test@test.test");
+  });
+
   it("should call onClose when the close button is clicked", async () => {
-    render(<FeedbackForm polarity="positive" onClose={onCloseMock} />);
+    render(<FeedbackForm onSubmit={onSubmitMock} onClose={onCloseMock} />);
     await user.click(screen.getByRole("button", { name: "Cancel" }));
 
+    expect(onSubmitMock).not.toHaveBeenCalled();
     expect(onCloseMock).toHaveBeenCalled();
   });
 
+  it("should disable the buttons if isSubmitting is true", () => {
+    const { rerender } = render(
+      <FeedbackForm onSubmit={onSubmitMock} onClose={onCloseMock} />,
+    );
+    const submitButton = screen.getByRole("button", { name: "Submit" });
+    const cancelButton = screen.getByRole("button", { name: "Cancel" });
+
+    expect(submitButton).not.toBeDisabled();
+    expect(cancelButton).not.toBeDisabled();
+
+    rerender(
+      <FeedbackForm
+        onSubmit={onSubmitMock}
+        onClose={onCloseMock}
+        isSubmitting
+      />,
+    );
+    expect(submitButton).toBeDisabled();
+    expect(cancelButton).toBeDisabled();
+  });
 });