Rename package from orb to orb_sdk

- Rename src/orb to src/orb_sdk
- Update pyproject.toml with new package name
- Update all internal imports
- Add sync-upstream.yml workflow for automated updates
- Add apply-customizations.sh script
- Use Python 3.13

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: 2 people

.github/workflows/sync-upstream.yml

@@ -0,0 +1,91 @@
+name: Sync Upstream
+
+on:
+  schedule:
+    - cron: '0 9 * * *'  # Daily at 9am UTC
+  workflow_dispatch:
+
+jobs:
+  check-and-sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Check for new upstream release
+        id: check
+        run: |
+          LATEST=$(curl -s https://api.github.com/repos/orbcorp/orb-python/releases/latest | jq -r .tag_name)
+          CURRENT=$(git describe --tags --abbrev=0 2>/dev/null || echo "none")
+
+          echo "Latest upstream: $LATEST"
+          echo "Current: $CURRENT"
+
+          if [ "$LATEST" != "$CURRENT" ]; then
+            echo "new_release=true" >> $GITHUB_OUTPUT
+            echo "version=$LATEST" >> $GITHUB_OUTPUT
+          else
+            echo "new_release=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Sync upstream changes
+        if: steps.check.outputs.new_release == 'true'
+        run: |
+          git remote add upstream https://github.com/orbcorp/orb-python.git || true
+          git fetch upstream --tags
+
+          # Create branch for the sync
+          git checkout -b sync-upstream-${{ steps.check.outputs.version }}
+
+          # Merge upstream tag
+          git merge ${{ steps.check.outputs.version }} -m "Merge upstream ${{ steps.check.outputs.version }}" || true
+
+      - name: Re-apply customizations
+        if: steps.check.outputs.new_release == 'true'
+        run: |
+          chmod +x ./scripts/apply-customizations.sh
+          ./scripts/apply-customizations.sh
+
+      - name: Set up Python
+        if: steps.check.outputs.new_release == 'true'
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install and test
+        if: steps.check.outputs.new_release == 'true'
+        run: |
+          pip install uv
+          uv pip install -e ".[dev]" --system
+          pytest tests/ -x -q
+
+      - name: Commit customizations
+        if: steps.check.outputs.new_release == 'true'
+        run: |
+          git add -A
+          git commit -m "Apply orb_sdk customizations" || true
+
+      - name: Push and create PR
+        if: steps.check.outputs.new_release == 'true'
+        run: |
+          git push -u origin sync-upstream-${{ steps.check.outputs.version }}
+          gh pr create \
+            --title "Sync upstream ${{ steps.check.outputs.version }}" \
+            --body "Automated sync from orbcorp/orb-python ${{ steps.check.outputs.version }}" \
+            --base main
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Enable auto-merge
+        if: steps.check.outputs.new_release == 'true'
+        run: |
+          gh pr merge --auto --squash
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.python-version

@@ -1 +1 @@
-3.9.18
+3.13.1

pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "orb-billing"
+name = "orb_sdk"
 version = "4.55.0"
 description = "The official Python library for the orb API"
 dynamic = ["readme"]
@@ -80,14 +80,14 @@ format = { chain = [
 "check:ruff" = "ruff check ."
 "fix:ruff" = "ruff check --fix ."
 
-"check:importable" = "python -c 'import orb'"
+"check:importable" = "python -c 'import orb_sdk'"
 
 typecheck = { chain = [
   "typecheck:pyright",
   "typecheck:mypy"
 ]}
 "typecheck:pyright" = "pyright"
-"typecheck:verify-types" = "pyright --verifytypes orb --ignoreexternal"
+"typecheck:verify-types" = "pyright --verifytypes orb_sdk --ignoreexternal"
 "typecheck:mypy" = "mypy ."
 
 [build-system]
@@ -100,7 +100,7 @@ include = [
 ]
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/orb"]
+packages = ["src/orb_sdk"]
 
 [tool.hatch.build.targets.sdist]
 # Basically everything except hidden files/directories (such as .github, .devcontainers, .python-version, etc)
@@ -168,7 +168,7 @@ show_error_codes = true
 #
 # We also exclude our `tests` as mypy doesn't always infer
 # types correctly and Pyright will still catch any type errors.
-exclude = ['src/orb/_files.py', '_dev/.*.py', 'tests/.*']
+exclude = ['src/orb_sdk/_files.py', '_dev/.*.py', 'tests/.*']
 
 strict_equality = true
 implicit_reexport = true
@@ -260,7 +260,7 @@ length-sort = true
 length-sort-straight = true
 combine-as-imports = true
 extra-standard-library = ["typing_extensions"]
-known-first-party = ["orb", "tests"]
+known-first-party = ["orb_sdk", "tests"]
 
 [tool.ruff.lint.per-file-ignores]
 "bin/**.py" = ["T201", "T203"]

scripts/apply-customizations.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+set -e
+
+echo "Applying orb_sdk customizations..."
+
+# Rename module directory if upstream merge restored 'orb'
+if [ -d "src/orb" ]; then
+  echo "Renaming src/orb -> src/orb_sdk"
+  rm -rf src/orb_sdk 2>/dev/null || true
+  mv src/orb src/orb_sdk
+fi
+
+# Update all internal imports in src/
+echo "Updating imports in src/"
+find src -name "*.py" -exec sed -i 's/from orb\([^_]\)/from orb_sdk\1/g' {} +
+find src -name "*.py" -exec sed -i 's/from orb$/from orb_sdk/g' {} +
+find src -name "*.py" -exec sed -i 's/import orb\([^_]\)/import orb_sdk\1/g' {} +
+find src -name "*.py" -exec sed -i 's/import orb$/import orb_sdk/g' {} +
+
+# Update imports in tests/
+echo "Updating imports in tests/"
+find tests -name "*.py" -exec sed -i 's/from orb\([^_]\)/from orb_sdk\1/g' {} +
+find tests -name "*.py" -exec sed -i 's/from orb$/from orb_sdk/g' {} +
+find tests -name "*.py" -exec sed -i 's/import orb\([^_]\)/import orb_sdk\1/g' {} +
+find tests -name "*.py" -exec sed -i 's/import orb$/import orb_sdk/g' {} +
+
+# Update pyproject.toml
+echo "Updating pyproject.toml"
+sed -i 's/name = "orb-billing"/name = "orb_sdk"/' pyproject.toml
+sed -i 's/packages = \["src\/orb"\]/packages = ["src\/orb_sdk"]/' pyproject.toml
+sed -i "s/\"check:importable\" = \"python -c 'import orb'\"/\"check:importable\" = \"python -c 'import orb_sdk'\"/" pyproject.toml
+sed -i 's/--verifytypes orb /--verifytypes orb_sdk /' pyproject.toml
+sed -i "s/exclude = \['src\/orb\/_files.py'/exclude = ['src\/orb_sdk\/_files.py'/" pyproject.toml
+sed -i 's/known-first-party = \["orb", "tests"\]/known-first-party = ["orb_sdk", "tests"]/' pyproject.toml
+
+echo "Customizations applied successfully"

src/orb/__init__.py src/orb_sdk/__init__.pysrc/orb/__init__.py renamed to src/orb_sdk/__init__.py

@@ -105,12 +105,12 @@
 # Update the __module__ attribute for exported symbols so that
 # error messages point to this module instead of the module
 # it was originally defined in, e.g.
-# orb._exceptions.NotFoundError -> orb.NotFoundError
+# orb_sdk._exceptions.NotFoundError -> orb_sdk.NotFoundError
 __locals = locals()
 for __name in __all__:
     if not __name.startswith("__"):
         try:
-            __locals[__name].__module__ = "orb"
+            __locals[__name].__module__ = "orb_sdk"
         except (TypeError, AttributeError):
             # Some of our exported symbols are builtins which we can't set attributes for.
             pass