tryx 0.3.0__tar.gz → 0.4.0__tar.gz

{tryx-0.3.0 → tryx-0.4.0}/.github/workflows/CI.yml

@@ -4,7 +4,6 @@ on:
   push:
     tags:
       - "v*"
-  pull_request:
   workflow_dispatch:
 
 permissions:
@@ -44,12 +43,8 @@ jobs:
         platform:
           - runner: ubuntu-22.04
             target: x86_64
-          - runner: ubuntu-22.04
-            target: x86
           - runner: ubuntu-22.04
             target: aarch64
-          - runner: ubuntu-22.04
-            target: armv7
     steps:
       - uses: actions/checkout@v4
         with:
@@ -58,19 +53,14 @@ jobs:
         with:
           python-version: "3.12"
       - name: Workaround ring ARM asm macro in cross builds
-        if: matrix.platform.target == 'aarch64' || matrix.platform.target == 'armv7'
-        run: |
-          if [ "${{ matrix.platform.target }}" = "aarch64" ]; then
-            echo "CFLAGS_aarch64_unknown_linux_gnu=-D__ARM_ARCH=8" >> "$GITHUB_ENV"
-          else
-            echo "CFLAGS_armv7_unknown_linux_gnueabihf=-D__ARM_ARCH=7" >> "$GITHUB_ENV"
-          fi
+        if: matrix.platform.target == 'aarch64'
+        run: echo "CFLAGS_aarch64_unknown_linux_gnu=-D__ARM_ARCH=8" >> "$GITHUB_ENV"
       - name: Build wheels
         uses: PyO3/maturin-action@v1
         with:
           target: ${{ matrix.platform.target }}
           args: --release --out dist --find-interpreter
-          sccache: ${{ !startsWith(github.ref, 'refs/tags/') && matrix.platform.target != 'aarch64' && matrix.platform.target != 'armv7' }}
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') && matrix.platform.target != 'aarch64' }}
           manylinux: auto
       - name: Upload wheels
         uses: actions/upload-artifact@v4
@@ -78,50 +68,6 @@ jobs:
           name: wheels-linux-${{ matrix.platform.target }}
           path: dist
 
-  musllinux:
-    name: Linux musllinux wheels
-    needs: quality
-    runs-on: ${{ matrix.platform.runner }}
-    strategy:
-      fail-fast: false
-      matrix:
-        platform:
-          - runner: ubuntu-22.04
-            target: x86_64
-          - runner: ubuntu-22.04
-            target: x86
-          - runner: ubuntu-22.04
-            target: aarch64
-          - runner: ubuntu-22.04
-            target: armv7
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          submodules: recursive
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-      - name: Workaround ring ARM asm macro in cross builds
-        if: matrix.platform.target == 'aarch64' || matrix.platform.target == 'armv7'
-        run: |
-          if [ "${{ matrix.platform.target }}" = "aarch64" ]; then
-            echo "CFLAGS_aarch64_unknown_linux_musl=-D__ARM_ARCH=8" >> "$GITHUB_ENV"
-          else
-            echo "CFLAGS_armv7_unknown_linux_musleabihf=-D__ARM_ARCH=7" >> "$GITHUB_ENV"
-          fi
-      - name: Build wheels
-        uses: PyO3/maturin-action@v1
-        with:
-          target: ${{ matrix.platform.target }}
-          args: --release --out dist --find-interpreter
-          sccache: ${{ !startsWith(github.ref, 'refs/tags/') && matrix.platform.target != 'aarch64' && matrix.platform.target != 'armv7' }}
-          manylinux: musllinux_1_2
-      - name: Upload wheels
-        uses: actions/upload-artifact@v4
-        with:
-          name: wheels-musllinux-${{ matrix.platform.target }}
-          path: dist
-
   windows:
     name: Windows wheels
     needs: quality
@@ -133,12 +79,6 @@ jobs:
           - runner: windows-latest
             target: x64
             python_arch: x64
-          - runner: windows-latest
-            target: x86
-            python_arch: x86
-          - runner: windows-11-arm
-            target: aarch64
-            python_arch: arm64
     steps:
       - uses: actions/checkout@v4
         with:
@@ -212,7 +152,7 @@ jobs:
   release:
     name: Publish to PyPI
     if: ${{ startsWith(github.ref, 'refs/tags/v') }}
-    needs: [musllinux, linux, windows, macos, sdist]
+    needs: [linux, windows, macos, sdist]
     runs-on: ubuntu-latest
     permissions:
       id-token: write

{tryx-0.3.0 → tryx-0.4.0}/.github/workflows/docs.yml

@@ -3,7 +3,7 @@ name: Documentation
 on:
   push:
     branches:
-      - main
+      - master
     paths:
       - "docs/**"
       - "mkdocs.yml"
@@ -45,7 +45,7 @@ jobs:
 
   deploy:
     name: Deploy docs
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
     needs: build
     runs-on: ubuntu-latest
     environment:

{tryx-0.3.0 → tryx-0.4.0}/.github/workflows/release.yml

@@ -2,6 +2,17 @@ name: Semantic Release
 
 on:
   workflow_dispatch:
+    inputs:
+      release_type:
+        description: "Version bump strategy"
+        required: true
+        default: auto
+        type: choice
+        options:
+          - auto
+          - patch
+          - minor
+          - major
 
 permissions:
   contents: write
@@ -21,6 +32,7 @@ jobs:
           echo "ref=${GITHUB_REF}"
           echo "actor=${GITHUB_ACTOR}"
           echo "default_branch=${{ github.event.repository.default_branch }}"
+          echo "release_type=${{ github.event.inputs.release_type || 'auto' }}"
 
       - uses: actions/checkout@v4
         with:
@@ -49,7 +61,13 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: uv run --no-project --with python-semantic-release==9.21.1 semantic-release version
+          RELEASE_TYPE: ${{ github.event.inputs.release_type || 'auto' }}
+        run: |
+          if [ "${RELEASE_TYPE}" = "auto" ]; then
+            uv run --no-project --with python-semantic-release==9.21.1 semantic-release version --no-vcs-release
+          else
+            uv run --no-project --with python-semantic-release==9.21.1 semantic-release version --no-vcs-release --"${RELEASE_TYPE}"
+          fi
 
       - name: Push release commit and tags
         run: git push --follow-tags origin HEAD:${{ github.event.repository.default_branch }}
@@ -72,6 +90,7 @@ jobs:
           if [ "${after_sha}" = "${{ steps.baseline.outputs.sha }}" ] && [ "${after_tag}" = "${{ steps.baseline.outputs.tag }}" ]; then
             echo "released=false" >> "$GITHUB_OUTPUT"
             echo "No new release generated in this run."
+            echo "Tip: use release_type=patch/minor/major to force a release when needed."
           else
             echo "released=true" >> "$GITHUB_OUTPUT"
             echo "Release generated. Latest tag: ${after_tag:-none}"

{tryx-0.3.0 → tryx-0.4.0}/CHANGELOG.md

@@ -1,6 +1,27 @@
 # CHANGELOG
 
 
+## v0.4.0 (2026-04-01)
+
+### Bug Fixes
+
+- **client**: Callback params
+  ([`b133efe`](https://github.com/krypton-byte/tryx/commit/b133efe7580636a27a87889d4000fb039e3d7e31))
+
+- **workflow**: Update branch references from 'main' to 'master' in documentation workflow
+  ([`9d64aa2`](https://github.com/krypton-byte/tryx/commit/9d64aa25963d42cb0f410bc0bae42f9469af5d5b))
+
+### Chores
+
+- **deps**: Update tryx version from 0.2.0 to 0.3.0 in Cargo.lock
+  ([`c0b7ab7`](https://github.com/krypton-byte/tryx/commit/c0b7ab71958c2749124da415302ddaee38c404c0))
+
+### Refactoring
+
+- **CI**: Streamline platform matrix and remove musllinux configuration
+  ([`2c2be2f`](https://github.com/krypton-byte/tryx/commit/2c2be2ff5c54601ade1c99efd715e41b5d7c53fb))
+
+
 ## v0.3.0 (2026-04-01)
 
 ### Features
@@ -22,9 +43,23 @@
 - **release**: Update default branch references in workflow and documentation
   ([`bc5a5cc`](https://github.com/krypton-byte/tryx/commit/bc5a5ccc1cb037cf813998d0ad865d66c30c6ae5))
 
+- **release**: Update default branch references in workflow and documentation
+  ([`3bb0cb2`](https://github.com/krypton-byte/tryx/commit/3bb0cb250dd8281a27707e39a181731ff6d2b3f2))
+
 - **test**: Update workflows for commit message validation and release automation
   ([`b940d91`](https://github.com/krypton-byte/tryx/commit/b940d91d89969590af84b56a52316803174c4f65))
 
+- **workflow**: Remove duplicate ref line in release workflow
+  ([`2e3667a`](https://github.com/krypton-byte/tryx/commit/2e3667a8a2801c8fb083a6e38b8d28cc8379ef49))
+
+- **workflow**: Update branch references from 'main' to 'master' in documentation workflow
+  ([`0d9ecc6`](https://github.com/krypton-byte/tryx/commit/0d9ecc63ed4ba76424e1f40e2086e1864ee0f07e))
+
+### Chores
+
+- **deps**: Update tryx version from 0.2.0 to 0.3.0 in Cargo.lock
+  ([`6bd891e`](https://github.com/krypton-byte/tryx/commit/6bd891e87b8befcf3468bd516d5f2ad403320e86))
+
 ### Documentation
 
 - Update contributing guidelines to clarify release automation and required secrets
@@ -35,9 +70,23 @@
 
 ### Features
 
+- **ci**: Reintroduce Linux and Windows wheel builds with updated configurations
+  ([`bb74fd2`](https://github.com/krypton-byte/tryx/commit/bb74fd227019c298853fe8bc038bb7424eba1d58))
+
+- **release**: Enhance workflow dispatch with release type options and improve documentation
+  ([`b477e44`](https://github.com/krypton-byte/tryx/commit/b477e44ac37b3f5b2d200de9cd5e46155094de3a))
+
+- **release**: Enhance workflow dispatch with release type options and improve documentation
+  ([`fb67cf9`](https://github.com/krypton-byte/tryx/commit/fb67cf9f01736ec55fbb97f54845b82a05e3b782))
+
 - **test**: Test
   ([`3bc6c04`](https://github.com/krypton-byte/tryx/commit/3bc6c04f8ce84802947c45ad9e9b8735ec615918))
 
+### Refactoring
+
+- **README**: Streamline content and enhance clarity by removing redundant sections
+  ([`32fcaec`](https://github.com/krypton-byte/tryx/commit/32fcaec8caf5d074ee257c4d29762645f0233cec))
+
 
 ## v0.1.0 (2026-04-01)
 

{tryx-0.3.0 → tryx-0.4.0}/CONTRIBUTING.md

@@ -94,7 +94,8 @@ Include:
 - If commits qualify (`feat`, `fix`, `perf`, or breaking), version and changelog are updated and a new tag (`vX.Y.Z`) is created.
 - If commits do not qualify (for example docs/chore only), release is a no-op and no publish is triggered.
 - After a tag is created, GitHub Release notes are generated automatically.
-- CI is then triggered on that tag to build artifacts and publish to PyPI.
+- CI release pipeline is tag-driven (`vX.Y.Z`) to build artifacts and publish to PyPI.
+- Workflow dispatch is kept only as internal fallback trigger from `Semantic Release` automation.
 
 ## Simple Trigger Guide
 
@@ -108,10 +109,11 @@ Use this rule of thumb for automatic versioning:
 How to trigger semantic release until publish to PyPI:
 
 1. Push commits to default branch (direct push or merged PR), using Conventional Commit messages.
-2. Open GitHub Actions and run `Semantic Release` on default branch.
-3. Workflow evaluates commits and creates tag `vX.Y.Z` when releasable commits exist.
-4. Workflow creates the corresponding GitHub Release.
-5. CI workflow runs on that tag and publishes artifacts to PyPI.
+2. Open GitHub Actions and run `Semantic Release` on the default branch.
+3. Choose `release_type`: `auto` (default) for commit-based bump, or `patch`/`minor`/`major` to force bump manually.
+4. Workflow evaluates commits and creates tag `vX.Y.Z` when releasable commits exist.
+5. Workflow creates the corresponding GitHub Release.
+6. CI workflow runs on that tag and publishes artifacts to PyPI.
 
 Manual fallback (if needed):
 

{tryx-0.3.0 → tryx-0.4.0}/Cargo.lock

@@ -2224,7 +2224,7 @@ dependencies = [
 
 [[package]]
 name = "tryx"
-version = "0.3.0"
+version = "0.4.0"
 dependencies = [
  "async-trait",
  "chrono",

{tryx-0.3.0 → tryx-0.4.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "tryx"
-version = "0.3.0"
+version = "0.4.0"
 edition = "2024"
 readme = "README.md"
 

tryx-0.4.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: tryx
+Version: 0.4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Dist: protobuf>=5.29.6
+License-File: LICENSE
+Summary: Rust-powered Python SDK for async WhatsApp automation with typed bindings and event-driven APIs
+Keywords: whatsapp,automation,rust,pyo3,async,tokio,bot,protobuf
+Author: krypton-byte
+Maintainer: krypton-byte
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Documentation, https://krypton-byte.github.io/tryx/
+Project-URL: Homepage, https://github.com/krypton-byte/tryx
+Project-URL: Issues, https://github.com/krypton-byte/tryx/issues
+Project-URL: Repository, https://github.com/krypton-byte/tryx
+
+# Tryx
+
+[![CI](https://img.shields.io/github/actions/workflow/status/krypton-byte/tryx/CI.yml?label=CI&style=for-the-badge&logo=githubactions)](https://github.com/krypton-byte/tryx/actions/workflows/CI.yml)
+[![Release](https://img.shields.io/github/actions/workflow/status/krypton-byte/tryx/release.yml?label=Release&style=for-the-badge&logo=githubactions)](https://github.com/krypton-byte/tryx/actions/workflows/release.yml)
+[![Docs](https://img.shields.io/badge/Docs-Live-0ea5e9?style=for-the-badge&logo=readthedocs&logoColor=white)](http://krypton-byte.tech/tryx/)
+[![Python](https://img.shields.io/badge/Python-3.8%2B-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
+[![Rust](https://img.shields.io/badge/Rust-Stable-000000?style=for-the-badge&logo=rust)](https://www.rust-lang.org/)
+[![Typed](https://img.shields.io/badge/Typing-PEP%20561-0ea5e9?style=for-the-badge)](https://peps.python.org/pep-0561/)
+[![License](https://img.shields.io/github/license/krypton-byte/tryx?style=for-the-badge)](LICENSE)
+
+Tryx is a Rust-powered Python SDK for building WhatsApp automations with an async-first API, strong typing, and production-focused performance.
+
+It combines:
+
+- Rust for protocol and runtime-heavy paths
+- PyO3 for Python bindings
+- Tokio for async orchestration
+- Typed Python package distribution (`.pyi` + `py.typed`)
+
+> Note: This project is an independent developer SDK and is not affiliated with WhatsApp or Meta.
+
+## Why Tryx
+
+- Async-first architecture for event-driven bots
+- Python-friendly API with namespace-based clients
+- High-performance native core for protocol and transport workloads
+- Typed interfaces for better editor support and safer integrations
+- Supports both async and blocking runtime styles
+
+## Quick Links
+
+- Documentation: http://krypton-byte.tech/tryx/
+- Contributing Guide: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Command Bot Example: [examples/command_bot.py](examples/command_bot.py)
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8+
+- Rust stable toolchain
+- `uv`
+
+### Development Install (Editable)
+
+```bash
+uv sync --group dev
+uv run maturin develop
+```
+
+### Build Wheels
+
+```bash
+uv run maturin build --release
+```
+
+## Quick Start
+
+```python
+import asyncio
+from tryx.backend import SqliteBackend
+from tryx.client import Tryx, TryxClient
+from tryx.events import EvMessage
+from tryx.waproto.whatsapp_pb2 import Message
+
+backend = SqliteBackend("whatsapp.db")
+bot = Tryx(backend)
+
+@bot.on(EvMessage)
+async def on_message(client: TryxClient, event: EvMessage) -> None:
+    text = event.data.get_text() or "<non-text>"
+    chat = event.data.message_info.source.chat
+    await client.send_message(chat, Message(conversation=f"Echo: {text}"))
+
+async def main() -> None:
+    await bot.run()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Feature Overview
+
+- Event-based handlers via `@bot.on(...)`
+- Runtime client namespaces:
+  - `contact`, `chat_actions`, `community`, `newsletter`, `groups`
+  - `status`, `chatstate`, `blocking`, `polls`, `presence`, `privacy`, `profile`
+- Media upload/download and message sending helpers
+- Typed helper utilities under `tryx.helpers`
+
+For complete API coverage, see the docs site and generated API pages.
+
+## Project Layout
+
+- `src/`: Rust core bindings and runtime integration
+- `python/tryx/`: Python package surface and type stubs
+- `python/tryx/waproto/`: generated protobuf Python modules
+- `examples/`: runnable usage examples
+- `docs/`: MkDocs sources
+
+## Development Workflow
+
+```bash
+# Lint and format check
+uv run ruff check .
+uv run ruff format --check .
+
+# Validate stubs
+uv run python scripts/check_stub_parity.py
+
+# Build docs locally
+uv sync --group docs
+uv run mkdocs serve
+```
+
+## Release Workflow (Maintainers)
+
+- Release is triggered manually via GitHub Actions (`Semantic Release`).
+- Version bump is automatic from Conventional Commits:
+  - `feat` -> minor
+  - `fix` / `perf` -> patch
+  - breaking change -> major
+- The workflow creates a Git tag (`vX.Y.Z`), creates a GitHub Release, then triggers CI for publish.
+
+## Troubleshooting
+
+### Native Module Import Error
+
+If you see `ModuleNotFoundError: No module named 'tryx._tryx'`:
+
+```bash
+uv run maturin develop --release
+```
+
+### Bot Not Running
+
+Ensure the bot runtime is started (`run` or `run_blocking`) before calling runtime client methods.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution and release guidelines.
+
+## License
+
+This project is licensed under the terms in [LICENSE](LICENSE).
+

tryx-0.4.0/README.md

@@ -0,0 +1,145 @@
+# Tryx
+
+[![CI](https://img.shields.io/github/actions/workflow/status/krypton-byte/tryx/CI.yml?label=CI&style=for-the-badge&logo=githubactions)](https://github.com/krypton-byte/tryx/actions/workflows/CI.yml)
+[![Release](https://img.shields.io/github/actions/workflow/status/krypton-byte/tryx/release.yml?label=Release&style=for-the-badge&logo=githubactions)](https://github.com/krypton-byte/tryx/actions/workflows/release.yml)
+[![Docs](https://img.shields.io/badge/Docs-Live-0ea5e9?style=for-the-badge&logo=readthedocs&logoColor=white)](http://krypton-byte.tech/tryx/)
+[![Python](https://img.shields.io/badge/Python-3.8%2B-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
+[![Rust](https://img.shields.io/badge/Rust-Stable-000000?style=for-the-badge&logo=rust)](https://www.rust-lang.org/)
+[![Typed](https://img.shields.io/badge/Typing-PEP%20561-0ea5e9?style=for-the-badge)](https://peps.python.org/pep-0561/)
+[![License](https://img.shields.io/github/license/krypton-byte/tryx?style=for-the-badge)](LICENSE)
+
+Tryx is a Rust-powered Python SDK for building WhatsApp automations with an async-first API, strong typing, and production-focused performance.
+
+It combines:
+
+- Rust for protocol and runtime-heavy paths
+- PyO3 for Python bindings
+- Tokio for async orchestration
+- Typed Python package distribution (`.pyi` + `py.typed`)
+
+> Note: This project is an independent developer SDK and is not affiliated with WhatsApp or Meta.
+
+## Why Tryx
+
+- Async-first architecture for event-driven bots
+- Python-friendly API with namespace-based clients
+- High-performance native core for protocol and transport workloads
+- Typed interfaces for better editor support and safer integrations
+- Supports both async and blocking runtime styles
+
+## Quick Links
+
+- Documentation: http://krypton-byte.tech/tryx/
+- Contributing Guide: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Command Bot Example: [examples/command_bot.py](examples/command_bot.py)
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8+
+- Rust stable toolchain
+- `uv`
+
+### Development Install (Editable)
+
+```bash
+uv sync --group dev
+uv run maturin develop
+```
+
+### Build Wheels
+
+```bash
+uv run maturin build --release
+```
+
+## Quick Start
+
+```python
+import asyncio
+from tryx.backend import SqliteBackend
+from tryx.client import Tryx, TryxClient
+from tryx.events import EvMessage
+from tryx.waproto.whatsapp_pb2 import Message
+
+backend = SqliteBackend("whatsapp.db")
+bot = Tryx(backend)
+
+@bot.on(EvMessage)
+async def on_message(client: TryxClient, event: EvMessage) -> None:
+    text = event.data.get_text() or "<non-text>"
+    chat = event.data.message_info.source.chat
+    await client.send_message(chat, Message(conversation=f"Echo: {text}"))
+
+async def main() -> None:
+    await bot.run()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Feature Overview
+
+- Event-based handlers via `@bot.on(...)`
+- Runtime client namespaces:
+  - `contact`, `chat_actions`, `community`, `newsletter`, `groups`
+  - `status`, `chatstate`, `blocking`, `polls`, `presence`, `privacy`, `profile`
+- Media upload/download and message sending helpers
+- Typed helper utilities under `tryx.helpers`
+
+For complete API coverage, see the docs site and generated API pages.
+
+## Project Layout
+
+- `src/`: Rust core bindings and runtime integration
+- `python/tryx/`: Python package surface and type stubs
+- `python/tryx/waproto/`: generated protobuf Python modules
+- `examples/`: runnable usage examples
+- `docs/`: MkDocs sources
+
+## Development Workflow
+
+```bash
+# Lint and format check
+uv run ruff check .
+uv run ruff format --check .
+
+# Validate stubs
+uv run python scripts/check_stub_parity.py
+
+# Build docs locally
+uv sync --group docs
+uv run mkdocs serve
+```
+
+## Release Workflow (Maintainers)
+
+- Release is triggered manually via GitHub Actions (`Semantic Release`).
+- Version bump is automatic from Conventional Commits:
+  - `feat` -> minor
+  - `fix` / `perf` -> patch
+  - breaking change -> major
+- The workflow creates a Git tag (`vX.Y.Z`), creates a GitHub Release, then triggers CI for publish.
+
+## Troubleshooting
+
+### Native Module Import Error
+
+If you see `ModuleNotFoundError: No module named 'tryx._tryx'`:
+
+```bash
+uv run maturin develop --release
+```
+
+### Bot Not Running
+
+Ensure the bot runtime is started (`run` or `run_blocking`) before calling runtime client methods.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution and release guidelines.
+
+## License
+
+This project is licensed under the terms in [LICENSE](LICENSE).

{tryx-0.3.0 → tryx-0.4.0}/pyproject.toml

@@ -46,6 +46,9 @@ classifiers = [
 ]
 urls = { Homepage = "https://github.com/krypton-byte/tryx", Repository = "https://github.com/krypton-byte/tryx", Documentation = "https://krypton-byte.github.io/tryx/", Issues = "https://github.com/krypton-byte/tryx/issues" }
 dynamic = ["version"]
+dependencies = [
+    "protobuf>=5.29.6",
+]
 
 [tool.maturin]
 module-name = "tryx._tryx"