mobilerun 0.6.0__tar.gz

mobilerun-0.6.0/.dockerignore

@@ -0,0 +1,5 @@
+*
+
+!droidrun
+!pyproject.toml
+!README.md

mobilerun-0.6.0/.github/workflows/black.yml

@@ -0,0 +1,19 @@
+name: Lint
+
+on: [push, pull_request]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      
+      - uses: psf/black@stable
+        with:
+          options: "--check --diff --verbose"
+          src: "."
+          version: "25.9.0"

mobilerun-0.6.0/.github/workflows/bounty.yml

@@ -0,0 +1,134 @@
+name: "Project V2: Status ← issue label"
+
+on:
+  issues:
+    types: [labeled]
+
+env:
+  ORG: droidrun
+  PROJECT_NUMBER: 2
+  PROJECT_TOKEN: ${{ secrets.BOUNTY_SECRET }}
+
+jobs:
+  update_status:
+    runs-on: ubuntu-latest
+    steps:
+
+      - name: Fetch project & field metadata
+        id: metadata
+        env:
+          GH_TOKEN: ${{ env.PROJECT_TOKEN }}
+        run: |
+          # 1) Query projectV2 ID and the Status field + its options
+          gh api graphql -f query='
+            query($org:String!,$num:Int!){
+              organization(login:$org){
+                projectV2(number:$num){
+                  id
+                  fields(first:20){
+                    nodes{
+                      ... on ProjectV2SingleSelectField{
+                        id
+                        name
+                        options { id name }
+                      }
+                    }
+                  }
+                }
+              }
+            }' \
+            -f org="${ORG}" -F num=${PROJECT_NUMBER} \
+            --jq '
+              .data.organization.projectV2 as $p |
+              ($p.id) as $projId |
+              ($p.fields.nodes[] | select(.name=="Status")) as $f |
+              {
+                projectId: $projId,
+                statusFieldId: $f.id,
+                options: ($f.options | map({(.name): .id}) | add)
+              }
+            ' > meta.json
+
+          # expose to GH env
+          echo "PROJECT_ID=$(jq -r .projectId meta.json)" >> $GITHUB_ENV
+          echo "STATUS_FIELD_ID=$(jq -r .statusFieldId meta.json)" >> $GITHUB_ENV
+          # options is an object like {"Eligible":"ID1","Bounty Posted":"ID2",...}
+          echo "STATUS_OPTIONS=$(jq -c .options meta.json)" >> $GITHUB_ENV
+
+      - name: Determine target option ID
+        id: pick
+        run: |
+          LABEL="${{ github.event.label.name }}"
+          # map label→ field option name
+          case "$LABEL" in
+            eligible)      OPT_NAME="📝 Eligible"      ;;
+            bounty-official) OPT_NAME="💰 Bounty" ;;
+            claimed)       OPT_NAME="🛠️ In Progress"   ;;
+            *) echo "No matching status for $LABEL"; exit 78 ;;
+          esac
+
+          # extract from JSON map
+          OPT_ID=$(echo "$STATUS_OPTIONS" | jq -r --arg name "$OPT_NAME" '.[$name]')
+          echo "OPTION_ID=$OPT_ID" >> $GITHUB_ENV
+
+      - name: Ensure issue is in the project
+        id: add_if_missing
+        env:
+          GH_TOKEN: ${{ env.PROJECT_TOKEN }}
+        run: |
+          ISSUE_NODE_ID=$(gh api graphql -f query='
+          query($owner:String!,$repo:String!,$number:Int!){
+            repository(owner:$owner, name:$repo){
+              issue(number:$number){
+                id
+                projectItems(first:1){
+                  nodes{ id }
+                }
+              }
+            }
+          }' \
+          -f owner="droidrun" \
+          -f repo="mobilerun" \
+          -F number=104 \
+          --jq '.data.repository.issue as $i |
+          { issueId: $i.id,
+            itemId: ($i.projectItems.nodes[0]?.id // "") }' )
+
+          # Save to file
+          echo "$ISSUE_NODE_ID" > issue.json
+          ISSUE_ID=$(jq -r .issueId issue.json)
+          ITEM_ID=$(jq -r .itemId issue.json)
+
+          if [ -z "$ITEM_ID" ]; then
+            ITEM_ID=$(gh api graphql -f query='
+              mutation($proj:ID!,$content:ID!){
+                addProjectV2ItemById(input:{projectId:$proj, contentId:$content}){
+                  item { id }
+                }
+              }' \
+              -f proj="${PROJECT_ID}" -f content="$ISSUE_ID" \
+              --jq '.data.addProjectV2ItemById.item.id')
+          fi
+          echo "ITEM_ID=$ITEM_ID" >> $GITHUB_ENV
+
+      - name: Update Status field
+        env:
+          GH_TOKEN: ${{ env.PROJECT_TOKEN }}
+        run: |
+          gh api graphql -f query='
+          mutation($proj:ID!,$item:ID!,$field:ID!,$opt:String!){
+            updateProjectV2ItemFieldValue(input:{
+              projectId: $proj,
+              itemId: $item,
+              fieldId: $field,
+              value: {
+                singleSelectOptionId: $opt
+              }
+            }) {
+              projectV2Item { id }
+            }
+          }' \
+          -f proj="${PROJECT_ID}" \
+          -f item="${ITEM_ID}" \
+          -f field="${STATUS_FIELD_ID}" \
+          -f opt="${OPTION_ID}"

mobilerun-0.6.0/.github/workflows/claude-code-review.yml

@@ -0,0 +1,57 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Please review this pull request and provide feedback on:
+            - Code quality and best practices
+            - Potential bugs or issues
+            - Performance considerations
+            - Security concerns
+            - Test coverage
+
+            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
+
+            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'

mobilerun-0.6.0/.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'
+

mobilerun-0.6.0/.github/workflows/docker.yml

@@ -0,0 +1,54 @@
+name: Publish Docker Image 🐳
+
+on:
+  push:
+    tags:
+      - "v*"
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  push-image:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      packages: write
+      attestations: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: all
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+
+      - name: Build and push multi-arch Docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          platforms: linux/amd64,linux/arm64
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

mobilerun-0.6.0/.github/workflows/publish.yml

@@ -0,0 +1,109 @@
+name: Publish Python 🐍 distribution 📦 to PyPI and TestPyPI
+on: push
+
+jobs:
+  version-check:
+    name: Check version matches tag and compat shim
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Compare tag to root and compat versions, verify dependency pin
+      run: |
+        TAG="${GITHUB_REF#refs/tags/v}"
+        ROOT_VERSION=$(sed -n 's/^version = "\(.*\)"/\1/p' pyproject.toml)
+        COMPAT_VERSION=$(sed -n 's/^version = "\(.*\)"/\1/p' compat/pyproject.toml)
+
+        if [ "$TAG" != "$ROOT_VERSION" ]; then
+          echo "::error::Tag v$TAG does not match pyproject.toml version $ROOT_VERSION"
+          exit 1
+        fi
+        if [ "$ROOT_VERSION" != "$COMPAT_VERSION" ]; then
+          echo "::error::Version mismatch: root=$ROOT_VERSION compat=$COMPAT_VERSION"
+          exit 1
+        fi
+        if ! grep -q "mobilerun==$ROOT_VERSION" compat/pyproject.toml; then
+          echo "::error::compat/pyproject.toml does not pin mobilerun==$ROOT_VERSION"
+          exit 1
+        fi
+        echo "Version check passed: v$ROOT_VERSION (root + compat aligned)"
+
+  build:
+    name: Build mobilerun + droidrun shim 📦
+    needs:
+    - version-check
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        persist-credentials: false
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.x"
+    - name: Install pypa/build
+      run: python3 -m pip install build --user
+    - name: Build mobilerun (root package)
+      run: python3 -m build
+    - name: Build droidrun (compat shim)
+      run: python3 -m build compat/
+    - name: Merge compat artifacts into dist/
+      run: cp compat/dist/* dist/
+    - name: Verify both packages built
+      run: |
+        ls dist/mobilerun-*.whl dist/mobilerun-*.tar.gz
+        ls dist/droidrun-*.whl dist/droidrun-*.tar.gz
+    - name: Store the distribution packages
+      uses: actions/upload-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+
+  publish-to-testpypi:
+    name: Publish mobilerun + droidrun shim to TestPyPI
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs:
+    - build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/mobilerun
+    permissions:
+      id-token: write
+    steps:
+    - name: Download all the dists
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+    - name: Publish both packages to TestPyPI
+      # Each wheel is routed to its matching PyPI project via OIDC.
+      # Both 'mobilerun' and 'droidrun' projects on TestPyPI must have this
+      # workflow configured as a trusted publisher (environment: testpypi).
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        repository-url: https://test.pypi.org/legacy/
+
+  publish-to-pypi:
+    name: Publish mobilerun + droidrun shim to PyPI
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs:
+    - publish-to-testpypi
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mobilerun
+    permissions:
+      id-token: write
+    steps:
+    - name: Download all the dists
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+    - name: Publish both packages to PyPI
+      # Each wheel is routed to its matching PyPI project via OIDC.
+      # Both 'mobilerun' and 'droidrun' projects on PyPI must have this
+      # workflow configured as a trusted publisher (environment: pypi).
+      uses: pypa/gh-action-pypi-publish@release/v1

mobilerun-0.6.0/.gitignore

@@ -0,0 +1,43 @@
+dist/
+build/
+# Python bytecode files
+__pycache__/
+*.py[cod]
+*$py.class
+trajectories/
+*.class
+
+test.py
+test.ipynb
+*.log
+
+messages_log.json
+
+.idea
+.vscode
+.vscode-test
+.vscode-test-*
+.idea/*
+.vscode/*
+patch_apis.py
+.git
+.arize-phoenix
+
+todo.txt
+
+config.yaml
+
+credentials.yaml
+**/credentials.yaml
+!**/credentials_example.yaml
+
+.*/
+!.gitignore
+!.github/
+
+backend/
+frontend/
+
+reddit_python_posts.json
+
+test/

mobilerun-0.6.0/.python-version

@@ -0,0 +1 @@
+3.13

mobilerun-0.6.0/CONTRIBUTING.md

@@ -0,0 +1,113 @@
+# Contributing to Mobilerun
+
+Thank you for your interest in contributing to Mobilerun! This document provides guidelines and instructions for contributing to the project.
+
+## Getting Started
+
+1. Fork the repository on GitHub
+2. Clone your fork:
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/mobilerun.git
+   cd mobilerun
+   ```
+3. Set up your development environment as described below
+
+## Development Setup
+
+1. Create and activate a virtual environment:
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+   ```
+
+2. Install development dependencies:
+   ```bash
+   pip install -e ".[dev]"
+   ```
+
+## Making Contributions
+
+1. Create a new branch for your feature:
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+2. Make your changes following our coding standards:
+   - Use type hints for Python functions
+   - Follow PEP 8 style guidelines
+   - Write descriptive commit messages
+   - Update documentation as needed
+
+3. Commit your changes:
+   ```bash
+   git add .
+   git commit -m "feat: add your feature description"
+   ```
+
+4. Push to your fork:
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+5. Open a Pull Request
+
+## Documentation
+
+- Update the README.md if you change functionality
+- Add docstrings to new functions and classes
+- Update the documentation in the `docs/` directory
+
+## Community
+
+- Join our [Discord server](https://discord.gg/ZZbKEZZkwK) for discussions
+- Follow us on [Twitter/X](https://x.com/mobilerun_ai)
+- Check our [Documentation](https://docs.mobilerun.ai)
+- Report bugs and request features through [GitHub Issues](https://github.com/droidrun/mobilerun/issues)
+
+## Security Checks
+
+To ensure the security of the codebase, we have integrated security checks using `bandit` and `safety`. These tools help identify potential security issues in the code and dependencies.
+
+### Running Security Checks
+
+Before submitting any code, please run the following security checks:
+
+1. **Bandit**: A tool to find common security issues in Python code.
+   ```bash
+   bandit -r mobilerun
+   ```
+
+2. **Safety**: A tool to check your installed dependencies for known security vulnerabilities.
+   ```bash
+   safety scan
+   ```
+
+## Pull Request Process
+
+1. Update documentation for any modified functionality
+2. Update the changelog if applicable
+3. Get at least one code review from a maintainer
+4. Once approved, a maintainer will merge your PR
+
+## Release Process
+
+Releases are handled by the maintainers. Version numbers follow [Semantic Versioning](https://semver.org/).
+
+## Questions?
+
+If you have questions about contributing:
+1. Check existing GitHub issues
+2. Ask in our Discord server
+3. Open a new GitHub issue for complex questions
+
+Thank you for contributing to Mobilerun! 🚀
+
+## Language
+
+English is the preferred language for all contributions, including:
+- Code comments
+- Documentation
+- Commit messages
+- Pull requests
+- Issue reports
+- Community discussions

mobilerun-0.6.0/Dockerfile

@@ -0,0 +1,27 @@
+FROM python:3.12-slim
+
+RUN groupadd -g 1000 mobilerun \
+    && useradd -m -u 1000 -g 1000 -s /bin/bash mobilerun
+
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+    curl \
+    android-tools-adb \
+    && rm -rf /var/lib/apt/lists/*
+
+USER mobilerun
+
+WORKDIR /mobilerun
+
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
+
+ENV PATH="/home/mobilerun/.local/bin:${PATH}"
+
+COPY . .
+
+RUN uv venv && \
+    uv pip --no-cache-dir install .[google,anthropic,openai,deepseek,ollama,openrouter]
+
+ENTRYPOINT [".venv/bin/mobilerun"]
+
+CMD ["setup"]

mobilerun-0.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Niels Schmidt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mobilerun-0.6.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include LICENSE
+include README.md
+include pyproject.toml
+
+recursive-include mobilerun *
+recursive-exclude * __pycache__
+recursive-exclude * *.py[cod]