chore(sdk-python): release 0.1.0b1 as the first public beta

- Accept canonical PEP 440 pre-releases (X.Y.Z{a|b|rc}N) in release_check.py
  and cover stable, pre-release and rejected npm-style versions in tests.
- Set the version to 0.1.0b1 and add the Beta development status classifier.
- Document --pre installation in the README and pre-release rules in
  RELEASING.md.

Author: 1anZhang

packages/code-sdk-python/CHANGELOG.md

@@ -4,9 +4,10 @@ All notable changes to the `minimax-code-sdk` Python package are documented here
 versioned independently of the MiniMax Code CLI and of the TypeScript SDK. The first
 `## X.Y.Z · YYYY-MM-DD` heading is the version being released; see [RELEASING.md](RELEASING.md).
 
-## 0.1.0 · 2026-11-03
+## 0.1.0b1 · 2026-11-03
 
-First public release.
+First public beta. Install it with `pip install --pre minimax-code-sdk`; the API may still
+change before `0.1.0`.
 
 ### Added
 

packages/code-sdk-python/README.md

@@ -11,6 +11,15 @@ It mirrors the TypeScript SDK
 - Python 3.10+
 - The `mcode` CLI (0.6.3 or newer): `npm install -g @minimax-ai/code`
 
+## Install
+
+```bash
+pip install --pre minimax-code-sdk   # or: uv add --prerelease=allow minimax-code-sdk
+```
+
+The SDK is in beta, so installers need `--pre` (or an exact version such as
+`minimax-code-sdk==0.1.0b1`) until `0.1.0` is released. Import it as `minimax_code`.
+
 The CLI is found from `MCodeOptions(bin=...)`, then the `MCODE_BIN` environment variable,
 then `PATH`.
 

packages/code-sdk-python/RELEASING.md

@@ -12,8 +12,10 @@ independently of the CLI and of `@minimax-ai/code-sdk`.
 - A published version is immutable. PyPI never accepts the same file name twice, even after a
   release is deleted. Fix problems in a new version; prefer **yanking** a broken release over
   deleting it.
-- Versions are stable `X.Y.Z`. There is no prerelease channel yet.
-- Release tags are `code-sdk-python-vX.Y.Z`. They are separate from CLI tags (`vX.Y.Z`) and
+- Versions are stable `X.Y.Z` or PEP 440 pre-releases `X.Y.ZaN`, `X.Y.ZbN` and `X.Y.ZrcN` (for
+  example `0.1.0b1`), written in canonical form. Never use npm-style `0.1.0-beta.1`. See
+  [Pre-releases](#pre-releases).
+- Release tags are `code-sdk-python-v<version>`, for example `code-sdk-python-v0.1.0b1`. They are separate from CLI tags (`vX.Y.Z`) and
   TypeScript SDK tags (`code-sdk-vX.Y.Z`). Never move or delete a pushed release tag.
 - Do not upload from a workstation. If the workflow is unavailable, fix the workflow.
 
@@ -86,6 +88,19 @@ The tag push starts the workflow. Its `build` job:
 The `publish-pypi` job then waits for approval on the `pypi` environment and uploads exactly the
 checked files with `pypa/gh-action-pypi-publish`, which also attaches PyPI attestations.
 
+## Pre-releases
+
+Pre-releases go to the real PyPI index through the same workflow and checks; only the version
+differs. Installers skip them unless the user passes `--pre` (pip), `--prerelease=allow` (uv) or
+pins the exact version, so `pip install minimax-code-sdk` keeps resolving to the newest stable
+release once one exists. Keep the README install instructions in line with the latest release.
+
+- Fix a broken pre-release with the next number (`0.1.0b2`), not by reusing a version.
+- Promote by releasing `0.1.0` with its own CHANGELOG section; earlier pre-releases stay in the
+  history and need no cleanup.
+- When the first stable release ships, drop `--pre` from the README install instructions and
+  replace `Development Status :: 4 - Beta` in `pyproject.toml` as appropriate.
+
 ## 4. Read back
 
 ```bash

packages/code-sdk-python/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "minimax-code-sdk"
-version = "0.1.0"
+version = "0.1.0b1"
 description = "Python SDK for driving the local MiniMax Code (mcode) agent."
 readme = "README.md"
 license = "MIT"
@@ -13,6 +13,7 @@ requires-python = ">=3.10"
 dependencies = ["typing_extensions>=4.7"]
 keywords = ["minimax", "minimax-code", "mcode", "agent", "coding-agent", "sdk"]
 classifiers = [
+  "Development Status :: 4 - Beta",
   "Programming Language :: Python :: 3",
   "Operating System :: OS Independent",
   "Typing :: Typed",

packages/code-sdk-python/scripts/release_check.py

@@ -26,7 +26,10 @@
 ROOT = Path(__file__).resolve().parent.parent
 INDEXES = {"pypi": "https://pypi.org", "testpypi": "https://test.pypi.org"}
 
-_VERSION = re.compile(r"\d+\.\d+\.\d+")
+# Stable X.Y.Z or a PEP 440 pre-release X.Y.Z{a|b|rc}N, in canonical form.
+_VERSION = re.compile(
+    r"(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:(?:a|b|rc)(?:0|[1-9]\d*))?"
+)
 _PROJECT_VERSION = re.compile(r'^version\s*=\s*"([^"]*)"\s*$', re.MULTILINE)
 _INIT_VERSION = re.compile(r'^__version__\s*=\s*"([^"]*)"\s*$', re.MULTILINE)
 _CHANGELOG_HEADING = re.compile(r"^## (\S+) · (\d{4}-\d{2}-\d{2})\s*$", re.MULTILINE)
@@ -73,19 +76,22 @@ def check_metadata(root: Path = ROOT, tag: str | None = None) -> str:
     version = meta.project_version
     problems: list[str] = []
     if version is None or not _VERSION.fullmatch(version):
-        problems.append(f"pyproject.toml [project].version must be X.Y.Z; found {version!r}.")
+        problems.append(
+            "pyproject.toml [project].version must be X.Y.Z or X.Y.Z{a|b|rc}N; "
+            f"found {version!r}."
+        )
     if meta.init_version != version:
         problems.append(
             f"src/{IMPORT_NAME}/__init__.py __version__ is {meta.init_version!r}, "
             f"pyproject.toml has {version!r}."
         )
     if meta.changelog_version != version:
         problems.append(
-            "The first CHANGELOG.md heading must be '## X.Y.Z · YYYY-MM-DD' for the release "
+            "The first CHANGELOG.md heading must be '## <version> · YYYY-MM-DD' for the release "
             f"version {version!r}; found {meta.changelog_version!r}."
         )
     if tag is not None and tag != f"{TAG_PREFIX}{version}":
-        problems.append(f"Tag {tag!r} does not match version {version!r} ({TAG_PREFIX}X.Y.Z).")
+        problems.append(f"Tag {tag!r} does not match version {version!r} ({TAG_PREFIX}<version>).")
     if problems:
         raise ReleaseCheckError("\n".join(problems))
     assert version is not None
@@ -178,7 +184,7 @@ def main(argv: list[str] | None = None) -> int:
     parser = argparse.ArgumentParser(description=__doc__.splitlines()[0] if __doc__ else None)
     sub = parser.add_subparsers(dest="command", required=True)
     meta = sub.add_parser("metadata", help="check versions, changelog and tag")
-    meta.add_argument("--tag", help=f"release tag, {TAG_PREFIX}X.Y.Z")
+    meta.add_argument("--tag", help=f"release tag, {TAG_PREFIX}<version>")
     meta.add_argument("--index", choices=sorted(INDEXES), help="fail if already published there")
     dist = sub.add_parser("dist", help="check the built wheel and sdist")
     dist.add_argument("dist_dir", type=Path)

packages/code-sdk-python/src/minimax_code/__init__.py

@@ -31,7 +31,7 @@
     Usage,
 )
 
-__version__ = "0.1.0"
+__version__ = "0.1.0b1"
 
 __all__ = [
     "MCODE_EXEC_EXIT_CODES",

packages/code-sdk-python/tests/test_release_check.py

@@ -38,6 +38,20 @@ def test_repository_metadata_is_consistent() -> None:
     assert rc.check_metadata() == minimax_code.__version__
 
 
+@pytest.mark.parametrize("version", ["0.1.0b1", "1.0.0a2", "2.3.4rc10", "1.2.3"])
+def test_metadata_accepts_stable_and_pre_release_versions(tmp_path: Path, version: str) -> None:
+    root = project(tmp_path, version=version, init=version, log=version)
+    assert rc.check_metadata(root, tag=f"code-sdk-python-v{version}") == version
+
+
+@pytest.mark.parametrize(
+    "version", ["0.1.0-beta.1", "0.1.0.dev1", "0.1.0beta1", "01.0.0", "0.1.0b"]
+)
+def test_metadata_rejects_non_canonical_versions(tmp_path: Path, version: str) -> None:
+    with pytest.raises(rc.ReleaseCheckError, match=r"X\.Y\.Z"):
+        rc.check_metadata(project(tmp_path, version=version, init=version, log=version))
+
+
 def test_metadata_accepts_matching_tag(tmp_path: Path) -> None:
     assert rc.check_metadata(project(tmp_path), tag="code-sdk-python-v1.2.3") == "1.2.3"