chore: import upstream snapshot with attribution

.github/workflows/github-monitor.yml

@@ -0,0 +1,63 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Template: copy this file to the MONITORED repo at
+#   .github/workflows/github-monitor.yml
+#
+# Required secrets in the monitored repo:
+#   - STORAGE_REPO_TOKEN   Fine-grained PAT with Contents: Read & Write on
+#                          the storage repo (e.g. DavdGao/agentscope-monitor).
+#   - DINGTALK_WEBHOOK     Dingtalk bot webhook URL.
+#   - DINGTALK_SECRET      (optional) Dingtalk bot signing secret.
+# ─────────────────────────────────────────────────────────────────────────────
+name: GitHub Monitor
+
+on:
+  issues:
+    types: [opened, closed, reopened]
+  issue_comment:
+    types: [created]
+  pull_request_target:
+    # synchronize is silent (stored only) — see SILENT_REALTIME_EVENTS in scripts/config.py.
+    # It's needed for the daily "PRs with new commits to re-review" section.
+    types: [opened, closed, reopened, synchronize, review_requested]
+  pull_request_review:
+    types: [submitted]
+  pull_request_review_comment:
+    types: [created]
+  discussion:
+    types: [created, answered]
+  discussion_comment:
+    types: [created]
+
+permissions:
+  contents: read
+
+jobs:
+  notify:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Checkout storage repo (notification scripts)
+        uses: actions/checkout@v4
+        with:
+          repository: DavdGao/agentscope-monitor
+          token: ${{ secrets.STORAGE_REPO_TOKEN }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: pip
+
+      - run: pip install -r requirements.txt
+
+      - name: Send notification
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          EVENT_PAYLOAD: ${{ toJson(github.event) }}
+          REPO_NAME: ${{ github.repository }}
+          RUN_ID: ${{ github.run_id }}
+          RUN_ATTEMPT: ${{ github.run_attempt }}
+          STORAGE_REPO: DavdGao/agentscope-monitor
+          STORAGE_REPO_TOKEN: ${{ secrets.STORAGE_REPO_TOKEN }}
+          DINGTALK_WEBHOOK: ${{ secrets.DINGTALK_WEBHOOK }}
+          DINGTALK_SECRET: ${{ secrets.DINGTALK_SECRET }}
+        run: python -m scripts.notify

.github/workflows/k8s-workspace.yml

@@ -0,0 +1,81 @@
+name: K8s Workspace Integration Tests
+
+# Runs the K8sWorkspace integration suite against a kind cluster.
+# The regular `unittest.yml` job also imports this test file, but every
+# test inside is guarded by `skipUnless(_KIND_AVAILABLE, ...)`, so it is
+# a no-op there. This workflow is where the tests actually execute.
+
+on:
+  push:
+    paths:
+      - "src/agentscope/workspace/**"
+      - "tests/workspace_k8s_test.py"
+      - "tests/docker/k8s_workspace_test.Dockerfile"
+      - ".github/workflows/k8s-workspace.yml"
+  pull_request:
+    paths:
+      - "src/agentscope/workspace/**"
+      - "tests/workspace_k8s_test.py"
+      - "tests/docker/k8s_workspace_test.Dockerfile"
+      - ".github/workflows/k8s-workspace.yml"
+
+jobs:
+  k8s-workspace-tests:
+    if: false == contains(github.event.pull_request.title, 'WIP')
+    # Ubuntu only: kind requires linux + docker; the test module's
+    # skipUnless would skip everything on Windows/macOS anyway.
+    runs-on: ubuntu-latest
+    timeout-minutes: 25
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: '3.11'
+
+      - name: Create kind cluster
+        uses: helm/kind-action@v1
+        with:
+          cluster_name: agentscope-test
+          wait: 120s
+
+      - name: Build K8s workspace test image
+        run: |
+          docker build \
+            -f tests/docker/k8s_workspace_test.Dockerfile \
+            -t agentscope-k8s-test:ci .
+
+      - name: Load image into kind
+        run: kind load docker-image agentscope-k8s-test:ci --name agentscope-test
+
+      - name: Create test namespace
+        run: kubectl create namespace agentscope
+
+      - name: Install project
+        run: |
+          uv pip install -q -e .[dev]
+          uv pip install pytest
+
+      - name: Run K8s workspace tests
+        env:
+          K8S_TEST_IMAGE: agentscope-k8s-test:ci
+          K8S_TEST_NAMESPACE: agentscope
+        run: pytest tests/workspace_k8s_test.py -v
+
+      - name: Dump cluster diagnostics on failure
+        if: failure()
+        run: |
+          echo "── pods ──"
+          kubectl get pods -A -o wide || true
+          echo "── pvcs ──"
+          kubectl get pvc -A || true
+          echo "── events ──"
+          kubectl get events -A --sort-by=.lastTimestamp | tail -n 50 || true
+          echo "── describe agentscope pods ──"
+          for p in $(kubectl -n agentscope get pods -o name 2>/dev/null); do
+            echo "── $p ──"
+            kubectl -n agentscope describe "$p" || true
+            kubectl -n agentscope logs "$p" --all-containers=true --tail=200 || true
+          done
+

.github/workflows/pr-title-check.yml

@@ -0,0 +1,49 @@
+name: PR Title Check
+
+on:
+  pull_request:
+    branches:
+      - main
+    types: [opened, edited, synchronize, reopened]
+
+jobs:
+  check-pr-title:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check PR Title Format
+        uses: amannn/action-semantic-pull-request@v6.1.1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          # Configure allowed types based on your requirements
+          types: |
+            feat
+            fix
+            docs
+            ci
+            refactor
+            test
+            chore
+            perf
+            style
+            build
+            revert
+          # Require a scope (the part in parentheses)
+          requireScope: false
+          # Scope pattern: only lowercase letters, numbers, hyphens, and underscores allowed
+          scopePattern: ^[a-z0-9_-]+$
+          scopePatternError: |
+            The scope (text in parentheses) must contain only lowercase letters, numbers, hyphens, and underscores.
+            Example: "feat(memory): add redis cache support"
+            Invalid: "feat(Memory): ..." or "feat(MEMORY): ..."
+          # Subject (description) must not be empty and must be lowercase
+          subjectPattern: ^(?![A-Z]).+$
+          subjectPatternError: |
+            The subject (description after colon) must start with a lowercase letter.
+            Example: "feat(memory): add redis cache support"
+          # Validate the entire PR title against the Conventional Commits spec
+          validateSingleCommit: false
+          # Ignore merge commits
+          ignoreLabels: |
+            ignore-semantic-pull-request
+

.github/workflows/pre-commit.yml

@@ -0,0 +1,35 @@
+name: Pre-commit
+
+on: [push, pull_request]
+
+jobs:
+  run:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: True
+      matrix:
+        os: [ubuntu-latest]
+    env:
+      OS: ${{ matrix.os }}
+      PYTHON: '3.11'
+    steps:
+    - uses: actions/checkout@master
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        python-version: '3.11'
+    - name: Install AgentScope
+      run: |
+        uv pip install -q -e .[dev]
+    - name: Install pre-commit
+      run: |
+        pre-commit install
+    - name: Pre-commit starts
+      run: |
+        pre-commit run --all-files > pre-commit.log 2>&1 || true
+        cat pre-commit.log
+        if grep -q Failed pre-commit.log; then
+          echo -e "\e[41m  [**FAIL**] Please install pre-commit and format your code first. \e[0m"
+          exit 1
+        fi
+        echo -e "\e[46m  ********************************Passed******************************** \e[0m"

.github/workflows/publish-pypi.yml

@@ -0,0 +1,43 @@
+# This workflow will upload a Python Package using Twine when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Publish PyPi Package
+
+on:
+  workflow_dispatch:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  deploy:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v6
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        python-version: '3.11'
+    - name: Install dependencies
+      run: |
+        uv pip install build
+    - name: Build package
+      run: python -m build
+    - name: Test installation
+      run: |
+        uv pip install dist/*.whl
+        python -c "import agentscope; print(agentscope.__version__)"
+    - name: Publish package
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        user: __token__
+        password: ${{ secrets.PYPI_API_TOKEN }}

.github/workflows/stale.yml

@@ -0,0 +1,35 @@
+# This workflow warns and then closes issues and PRs that have had no activity for a specified amount of time.
+#
+# You can adjust the behavior by modifying this file.
+# For more information, see:
+# https://github.com/actions/stale
+name: Mark stale issues and pull requests
+
+on:
+  schedule:
+  - cron: '30 9 * * *'
+
+jobs:
+  stale:
+
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+
+    steps:
+    - uses: actions/stale@v10
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-issue-message: 'This issue is marked as stale because there has been no activity for 60 days. Remove stale label or add new comments or this issue will be closed in 90 day.'
+        close-issue-message: 'Close this stale issue.'
+        stale-issue-label: 'stale-issue'
+        exempt-issue-labels: 'RoadMap,Roadmap'
+        days-before-stale: 60
+        days-before-close: 30
+
+        stale-pr-message: 'This PR is marked as stale because there has been no activity for 60 days. Remove stale label or add new comments or this PR will be closed in 30 days.'
+        close-pr-message: 'Close this stale PR.'
+        stale-pr-label: 'stale-pr'
+        days-before-pr-stale: 60
+        days-before-pr-close: 30

.github/workflows/unittest.yml

@@ -0,0 +1,32 @@
+name: Python Unittest Coverage
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    if: false == contains(github.event.pull_request.title, 'WIP')
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-15]
+        python-version: ['3.11']
+    env:
+      OS: ${{ matrix.os }}
+    steps:
+    - uses: actions/checkout@master
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install Dev Dependencies
+      run: |
+        uv pip install -q -e .[dev]
+        uv pip install coverage pytest
+    - name: Run tests with coverage
+      env:
+        GRPC_VERBOSITY: ERROR
+      run: |
+        coverage run -m pytest tests
+    - name: Generate coverage report
+      run: |
+        coverage report -m

.github/workflows/update_news.yml

@@ -0,0 +1,39 @@
+name: Update NEWS in README
+on:
+  push:
+    paths:
+      - 'docs/NEWS.md'
+      - 'docs/NEWS_zh.md'
+    branches-ignore:
+      - 'main'
+
+# Prevent concurrent runs that modify README files
+concurrency:
+  group: readme-updates-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  updateNews:
+    name: NEWS Updater
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.10'
+
+      - name: Update NEWS in README files
+        run: python .github/scripts/update_news.py
+
+      - name: Commit changes
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          git add README.md README_zh.md
+          git diff --staged --quiet || git commit -m "docs: auto-sync NEWS section to README files"
+          git push
+

.github/workflows/web-ui.yml

@@ -0,0 +1,46 @@
+name: Web UI
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - ".github/workflows/web-ui.yml"
+      - "examples/web_ui/**"
+  pull_request:
+    branches:
+      - main
+    paths:
+      - ".github/workflows/web-ui.yml"
+      - "examples/web_ui/**"
+
+jobs:
+  check:
+    if: github.event_name != 'pull_request' || false == contains(github.event.pull_request.title, 'WIP')
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: examples/web_ui
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+          cache-dependency-path: examples/web_ui/pnpm-lock.yaml
+
+      - name: Install dependencies
+        run: pnpm install --no-frozen-lockfile
+
+      - name: Check formatting
+        run: pnpm format:check
+
+      - name: Build
+        run: pnpm build