Seam Python SDK version 3

.devcontainer/Dockerfile

@@ -3,8 +3,8 @@ ARG VARIANT="3"
 FROM mcr.microsoft.com/vscode/devcontainers/python:${VARIANT}
 
 ARG NODE_VERSION="24"
-ARG POETRY_VERSION="1.8.2"
-ARG POETRY_SRC="https://install.python-poetry.org"
+ARG UV_VERSION="0.8.17"
+ARG UV_SRC="https://astral.sh/uv"
 
 # https://github.com/microsoft/vscode-dev-containers/blob/main/containers/go/.devcontainer/base.Dockerfile
 ENV USERNAME=vscode
@@ -25,9 +25,7 @@ RUN apt-get update -y \
 USER vscode
 WORKDIR /home/vscode
 
-RUN curl -fsSL -o install-poetry.py "${POETRY_SRC}" \
- && python install-poetry.py --version $POETRY_VERSION \
- && rm install-poetry.py
+RUN curl -fsSL "${UV_SRC}/${UV_VERSION}/install.sh" | sh
 
 RUN mkdir -p .config/git \
  && echo ".vscode/*" >> .config/git/ignore \

.devcontainer/devcontainer.json

@@ -5,12 +5,11 @@
     "dockerfile": "Dockerfile",
     "args": {
       "NODE_VERSION": "24",
-      "POETRY_VERSION": "1.8.2",
-      "VARIANT": "3.12"
+      "UV_VERSION": "0.8.17",
+      "VARIANT": "3.14"
     }
   },
   "remoteEnv": {
-    "POETRY_VIRTUALENVS_IN_PROJECT": "true",
     "PATH": "${containerEnv:PATH}:/home/vscode/.local/bin"
   },
   "extensions": [
@@ -19,6 +18,6 @@
     "EditorConfig.EditorConfig",
     "esbenp.prettier-vscode"
   ],
-  "postCreateCommand": "poetry install && npm install",
+  "postCreateCommand": "uv sync && npm install",
   "remoteUser": "vscode"
 }

.github/actions/setup/action.yml

@@ -6,11 +6,7 @@ inputs:
   python_version:
     description: The Python version.
     required: false
-    default: '3.12'
-  poetry_version:
-    description: The Poetry version.
-    required: false
-    default: '1.8.2'
+    default: '3.14'
   just_version:
     description: The just version.
     required: false
@@ -23,46 +19,20 @@ inputs:
 runs:
   using: composite
   steps:
-    - name: Setup Poetry cache on Linux
-      uses: actions/cache@v4
-      if: runner.os == 'Linux'
-      with:
-        key: poetry-${{ inputs.poetry_version }}-${{ inputs.python_version }}-${{ runner.os }}-${{ runner.arch }}
-        path: |
-          ~/.local/bin
-          ~/.local/share/pypoetry
-    - name: Setup Poetry cache on macOS
-      uses: actions/cache@v4
-      if: runner.os == 'macOS'
-      with:
-        key: poetry-${{ inputs.poetry_version }}-${{ inputs.python_version }}-${{ runner.os }}-${{ runner.arch }}
-        path: |
-          ~/.local/bin
-          ~/.local/share/pypoetry
-          ~/Library/Application Support/pypoetry
     - name: Setup just
       uses: extractions/setup-just@v4
       with:
         just-version: ${{ inputs.just_version }}
-    - name: Setup Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ inputs.python_version }}
-    - name: Setup Poetry
-      uses: Gr1N/setup-poetry@v9
-      with:
-        poetry-version: ${{ inputs.poetry_version }}
-    - name: Setup Python with cache
-      uses: actions/setup-python@v5
-      if: inputs.install_dependencies == 'true'
+    - name: Setup uv
+      uses: astral-sh/setup-uv@v7
       with:
-        cache: poetry
         python-version: ${{ inputs.python_version }}
+        enable-cache: true
     - name: Check lockfile
       if: inputs.install_dependencies == 'true'
       shell: bash
-      run: poetry check --lock
+      run: uv lock --check
     - name: Install dependencies
       if: inputs.install_dependencies == 'true'
       shell: bash
-      run: poetry install --sync
+      run: uv sync

.github/workflows/_build.yml

@@ -8,7 +8,7 @@ on:
         description: The Python version.
         type: string
         required: false
-        default: '3.12'
+        default: '3.14'
       runs_on:
         description: The runner environment.
         type: string

.github/workflows/_publish.yml

@@ -31,7 +31,6 @@ jobs:
           name: ${{ inputs.artifact_name }}
           path: dist/
       - name: Publish
-        run: poetry publish --skip-existing -u $USERNAME -p $PASSWORD
+        run: uv publish --check-url https://pypi.org/simple/
         env:
-          USERNAME: __token__
-          PASSWORD: ${{ secrets.registry_token }}
+          UV_PUBLISH_TOKEN: ${{ secrets.registry_token }}

.github/workflows/check.yml

@@ -20,9 +20,10 @@ jobs:
         os:
           - ubuntu-latest
         python:
-          - '3.10'
           - '3.11'
           - '3.12'
+          - '3.13'
+          - '3.14'
         include:
           - os: ubuntu-latest
             os_name: Linux
@@ -47,6 +48,8 @@ jobs:
         python:
           - '3.11'
           - '3.12'
+          - '3.13'
+          - '3.14'
     steps:
       - name: Checkout
         uses: actions/checkout@v7
@@ -69,9 +72,10 @@ jobs:
         os:
           - ubuntu-latest
         python:
-          - '3.10'
           - '3.11'
           - '3.12'
+          - '3.13'
+          - '3.14'
         include:
           - os: ubuntu-latest
             os_name: Linux
@@ -86,9 +90,10 @@ jobs:
         os:
           - ubuntu-latest
         python:
-          - '3.10'
           - '3.11'
           - '3.12'
+          - '3.13'
+          - '3.14'
         include:
           - os: ubuntu-latest
             os_name: Linux

.github/workflows/generate.yml

@@ -35,12 +35,12 @@ jobs:
         uses: ./.github/actions/setup-node
         with:
           install_dependencies: 'false'
-      - name: Normalize poetry.lock
-        run: poetry lock --no-update
+      - name: Normalize uv.lock
+        run: uv lock
       - name: Normalize package-lock.json
         run: npm install
       - name: Install dependencies
-        run: poetry install --sync
+        run: uv sync
       - name: Generate code
         run: npm run generate
       - name: Commit

.github/workflows/prune.yml

@@ -7,7 +7,7 @@ on:
     - cron: '0 15 * * 3'
 
 jobs:
-  tag:
+  branches:
     name: Prune Branches
     runs-on: 'ubuntu-latest'
     timeout-minutes: 30

.github/workflows/semantic-release.yml

@@ -25,6 +25,31 @@ jobs:
         uses: actions/checkout@v7
         with:
           fetch-depth: 0
+      - name: Mirror prerelease tags as semver
+        run: |
+          # Prerelease tags use PEP 440 (v3.0.0b1) to match the published
+          # package version, but semantic-release only understands semver and
+          # silently ignores tags it cannot parse. Without this, every run
+          # reports the first prerelease of the channel as the next version.
+          # Mirror each PEP 440 prerelease tag onto its semver equivalent
+          # (v3.0.0-beta.1). These are local to the run and are never pushed;
+          # the PEP 440 tags remain the only real ones. The channel notes the
+          # Version workflow records against the tagged commit apply to the
+          # mirrored tag too, since notes attach to commits, not tags.
+          for tag in $(git tag --list 'v*'); do
+            semver="$(
+              printf '%s' "${tag#v}" | sed -E \
+                -e 's/^([0-9]+\.[0-9]+\.[0-9]+)a([0-9]+)$/\1-alpha.\2/' \
+                -e 's/^([0-9]+\.[0-9]+\.[0-9]+)b([0-9]+)$/\1-beta.\2/' \
+                -e 's/^([0-9]+\.[0-9]+\.[0-9]+)rc([0-9]+)$/\1-rc.\2/'
+            )"
+            if [ "$semver" = "${tag#v}" ]; then
+              continue
+            fi
+
+            git tag --force "v$semver" "$tag^{commit}"
+            echo "Mirrored $tag as v$semver."
+          done
       - name: Semantic release
         id: release
         uses: cycjimmy/semantic-release-action@v6

.github/workflows/version.yml

@@ -31,20 +31,28 @@ jobs:
           passphrase: ${{ secrets.GPG_PASSPHRASE }}
       - name: Setup
         uses: ./.github/actions/setup
+      # uv normalizes the semver version semantic-release computes
+      # (3.0.0-beta.1) to PEP 440 (3.0.0b1), which is what gets committed,
+      # tagged and published. The Semantic Release workflow mirrors that tag
+      # back to semver so it can pick up where the last prerelease left off.
       - name: Cut ${{ github.event.inputs.version }} version
         run: |
-          poetry version "${{ github.event.inputs.version }}"
+          uv version "${{ github.event.inputs.version }}"
           just version
+      # semantic-release only treats a prerelease tag as released when a note
+      # records the channel it went out on, so record it here, once the release
+      # exists. The note is keyed to the commit rather than the tag, which is
+      # what lets the mirrored semver tag pick it up.
       - name: Record prerelease channel
-        env:
-          VERSION: ${{ github.event.inputs.version }}
         run: |
-          case "$VERSION" in
-            *-*) channel="${VERSION#*-}"; channel="${channel%%.*}" ;;
+          tag="v$(uv version --short)"
+          case "$(uv version --short)" in
+            *.*.*a[0-9]*) channel=alpha ;;
+            *.*.*b[0-9]*) channel=beta ;;
+            *.*.*rc[0-9]*) channel=rc ;;
             *) echo "Stable release, no channel note required."; exit 0 ;;
           esac
-          git fetch origin "+refs/notes/semantic-release:refs/notes/semantic-release" || true
-          git notes --ref semantic-release add --force \
-            --message "{\"channels\":[\"$channel\"]}" "v$VERSION^{commit}"
-          git push origin refs/notes/semantic-release
-          echo "Recorded v$VERSION on the '$channel' channel."
+          git notes --ref "semantic-release-$tag" add --force \
+            --message "{\"channels\":[\"$channel\"]}" "$tag^{commit}"
+          git push origin "refs/notes/semantic-release-$tag"
+          echo "Recorded $tag on the '$channel' channel."

.gitignore

@@ -110,12 +110,12 @@ ipython_config.py
 #   install all needed dependencies.
 #Pipfile.lock
 
-# poetry
-#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+# uv
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
 #   This is especially recommended for binary packages to ensure reproducibility, and is more
 #   commonly ignored for libraries.
-#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
-#poetry.lock
+#   https://docs.astral.sh/uv/concepts/projects/sync/#checking-the-lockfile
+#uv.lock
 
 # pdm
 #   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.

.python-version

@@ -1 +1 @@
-3.12.2
+3.14