chat-sdk 0.0.1a4__tar.gz

chat_sdk-0.0.1a4/.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# Default owners for everything
+* @patrick-chinchill

chat_sdk-0.0.1a4/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,18 @@
+---
+name: Bug Report
+about: Report a bug
+labels: bug
+---
+
+**Adapter**: (e.g., Slack, Discord, Teams)
+**Version**: (e.g., 0.0.1a3)
+**Python version**: (e.g., 3.12)
+
+**What happened?**
+
+**What did you expect?**
+
+**Minimal reproduction**:
+```python
+# paste code here
+```

chat_sdk-0.0.1a4/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,9 @@
+---
+name: Feature Request
+about: Suggest a feature
+labels: enhancement
+---
+
+**What problem does this solve?**
+
+**Proposed solution**:

chat_sdk-0.0.1a4/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read   # checkout private repo
+      id-token: write  # trusted publishing
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4.2.2
+      - uses: astral-sh/setup-uv@e4db8464a088ece1b920f60402e813ea4de65b8f  # v4
+      - name: Build
+        run: uv build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e  # release/v1

chat_sdk-0.0.1a4/.github/workflows/test-publish.yml

@@ -0,0 +1,21 @@
+name: Publish to TestPyPI
+
+on:
+  workflow_dispatch:  # manual trigger only
+
+jobs:
+  test-publish:
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      contents: read   # checkout private repo
+      id-token: write  # trusted publishing
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4.2.2
+      - uses: astral-sh/setup-uv@e4db8464a088ece1b920f60402e813ea4de65b8f  # v4
+      - name: Build
+        run: uv build
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e  # release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

chat_sdk-0.0.1a4/.github/workflows/test.yml

@@ -0,0 +1,27 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4.2.2
+      - uses: astral-sh/setup-uv@e4db8464a088ece1b920f60402e813ea4de65b8f  # v4
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: uv sync --group dev
+      - name: Lint
+        run: uv run ruff check src/
+      - name: Format check
+        run: uv run ruff format --check src/
+      - name: Run tests
+        run: uv run pytest tests/ -q --tb=short --cov=chat_sdk --cov-fail-under=70

chat_sdk-0.0.1a4/.gitignore

@@ -0,0 +1,17 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+.env
+.env.*
+*.pem
+*.key
+.ruff_cache/
+.pytest_cache/
+.mypy_cache/
+uv.lock

chat_sdk-0.0.1a4/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.0.1a4 (2026-04-06)
+
+Initial alpha release.
+
+- Core SDK: Chat orchestrator, Thread, Channel, Message, Cards, Modals, Emoji
+- 8 adapters: Slack, Discord, Teams, Telegram, WhatsApp, Google Chat, GitHub, Linear
+- 3 state backends: Memory, Redis, PostgreSQL
+- 2,477 tests passing, 79% coverage
+- Security hardened: JWT verification, SSRF protection, timing-safe comparisons

chat_sdk-0.0.1a4/CONTRIBUTING.md

@@ -0,0 +1,55 @@
+# Contributing to chat-sdk-python
+
+Thanks for your interest in contributing! This guide covers the essentials.
+
+## Dev Environment Setup
+
+```bash
+# Clone and install (requires Python 3.11+ and uv)
+git clone https://github.com/Chinchill-AI/chat-sdk-python.git
+cd chat-sdk-python
+uv sync --group dev
+```
+
+## Running Tests
+
+```bash
+uv run pytest tests/               # all tests
+uv run pytest tests/ -x            # stop on first failure
+uv run pytest tests/unit/          # unit tests only
+```
+
+## Code Quality
+
+```bash
+uv run ruff check src/ tests/      # lint
+uv run ruff format src/ tests/     # auto-format
+```
+
+All PRs must pass `ruff check` with zero errors.
+
+## Adding a New Adapter
+
+1. Create `src/chat_sdk/adapters/<platform>/` with at minimum:
+   - `adapter.py` -- the adapter class implementing the Adapter protocol
+   - `__init__.py` -- public exports and a `create_<platform>_adapter()` factory
+2. Follow the patterns in existing adapters (Slack and Teams are good references).
+3. Add an optional-dependency group in `pyproject.toml`.
+4. Add tests under `tests/unit/adapters/<platform>/`.
+
+## Pull Request Expectations
+
+- **Tests required.** Every bugfix or feature needs at least one test.
+- **Ruff clean.** `uv run ruff check src/ tests/` must pass with no errors.
+- **Small, focused PRs** are easier to review than large ones.
+- **Descriptive commit messages.** Explain *why*, not just *what*.
+
+## Issues and PRs
+
+- Check existing issues before opening a new one.
+- Reference the issue number in your PR description (e.g., `Fixes #42`).
+- For large changes, open an issue first to discuss the approach.
+
+## License
+
+By contributing you agree that your contributions will be licensed under the MIT License.

chat_sdk-0.0.1a4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chinchill AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

chat_sdk-0.0.1a4/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: chat-sdk
+Version: 0.0.1a4
+Summary: Multi-platform async chat SDK for Python — port of Vercel Chat
+Project-URL: Homepage, https://github.com/Chinchill-AI/chat-sdk-python
+Project-URL: Repository, https://github.com/Chinchill-AI/chat-sdk-python
+Project-URL: Issues, https://github.com/Chinchill-AI/chat-sdk-python/issues
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Chat
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Provides-Extra: all
+Requires-Dist: aiohttp>=3.9; extra == 'all'
+Requires-Dist: asyncpg>=0.29; extra == 'all'
+Requires-Dist: cryptography>=42.0; extra == 'all'
+Requires-Dist: google-auth>=2.0; extra == 'all'
+Requires-Dist: pyjwt[crypto]>=2.8; extra == 'all'
+Requires-Dist: pynacl>=1.5; extra == 'all'
+Requires-Dist: redis>=5.0; extra == 'all'
+Requires-Dist: slack-sdk>=3.27.0; extra == 'all'
+Provides-Extra: crypto
+Requires-Dist: cryptography>=42.0; extra == 'crypto'
+Provides-Extra: discord
+Requires-Dist: aiohttp>=3.9; extra == 'discord'
+Requires-Dist: pynacl>=1.5; extra == 'discord'
+Provides-Extra: github
+Requires-Dist: pyjwt[crypto]>=2.8; extra == 'github'
+Provides-Extra: google-chat
+Requires-Dist: aiohttp>=3.9; extra == 'google-chat'
+Requires-Dist: google-auth>=2.0; extra == 'google-chat'
+Requires-Dist: pyjwt>=2.8; extra == 'google-chat'
+Provides-Extra: linear
+Requires-Dist: aiohttp>=3.9; extra == 'linear'
+Provides-Extra: postgres
+Requires-Dist: asyncpg>=0.29; extra == 'postgres'
+Provides-Extra: redis
+Requires-Dist: redis>=5.0; extra == 'redis'
+Provides-Extra: slack
+Requires-Dist: slack-sdk>=3.27.0; extra == 'slack'
+Provides-Extra: teams
+Requires-Dist: aiohttp>=3.9; extra == 'teams'
+Provides-Extra: telegram
+Requires-Dist: aiohttp>=3.9; extra == 'telegram'
+Provides-Extra: whatsapp
+Requires-Dist: aiohttp>=3.9; extra == 'whatsapp'
+Description-Content-Type: text/markdown
+
+# chat-sdk-python
+
+Multi-platform async chat SDK for Python. Port of [Vercel Chat](https://github.com/vercel/chat).
+
+> **Status: Alpha (0.0.1a4)** — API may change. Not yet tested in production.
+
+## Why chat-sdk?
+
+- **Write once, deploy to 8 platforms.** One handler runs on Slack, Discord, Teams, Telegram, WhatsApp, Google Chat, GitHub, and Linear.
+- **Built-in concurrency primitives.** Deduplication, thread locking, and message queuing are handled for you.
+- **Cross-platform cards.** Author a `Card` once and it renders as Block Kit (Slack), Adaptive Cards (Teams), embeds (Discord), and more.
+- **Not a replacement for platform SDKs.** chat-sdk is built *on top of* them. You can always drop down to the native SDK when you need to.
+
+## Install
+
+```bash
+pip install chat-sdk                   # core only
+pip install chat-sdk[slack]            # + Slack adapter
+pip install chat-sdk[all]              # all adapters + state backends
+```
+
+## Quick Start
+
+```python
+from chat_sdk import Chat, Card, Button, Actions, MemoryStateAdapter
+from chat_sdk.adapters.slack import create_slack_adapter
+
+chat = Chat(
+    adapters={"slack": create_slack_adapter()},
+    state=MemoryStateAdapter(),
+    user_name="my-bot",
+)
+
+@chat.on_mention
+async def handle_mention(thread, message):
+    await thread.post(
+        Card(title="Hello!", children=[
+            Actions([Button(id="hi", label="Say Hi")])
+        ])
+    )
+```
+
+## Adapters
+
+| Platform | Install Extra | Status |
+|----------|--------------|--------|
+| Slack | `chat-sdk[slack]` | Alpha |
+| Discord | `chat-sdk[discord]` | Alpha |
+| Teams | `chat-sdk[teams]` | Alpha |
+| Telegram | `chat-sdk[telegram]` | Alpha |
+| WhatsApp | `chat-sdk[whatsapp]` | Alpha |
+| Google Chat | `chat-sdk[google-chat]` | Alpha |
+| GitHub | `chat-sdk[github]` | Alpha |
+| Linear | `chat-sdk[linear]` | Alpha |
+
+## State Backends
+
+| Backend | Install Extra |
+|---------|--------------|
+| In-Memory | Built-in |
+| Redis | `chat-sdk[redis]` |
+| PostgreSQL | `chat-sdk[postgres]` |
+
+## Compared to Alternatives
+
+| Feature | chat-sdk | Raw platform SDKs | BotFramework SDK |
+|---------|----------|--------------------|------------------|
+| Multi-platform from one codebase | 8 platforms | 1 per SDK | Teams + limited |
+| Async-native (Python 3.11+) | Yes | Varies | No |
+| Cross-platform cards | Card model | Platform-specific | Adaptive Cards only |
+| Thread locking / dedup | Built-in | DIY | DIY |
+| State abstraction (mem/redis/pg) | Built-in | DIY | DIY |
+| Drop down to native SDK | Yes | N/A | Partially |
+
+## Development
+
+```bash
+uv sync --group dev
+uv run pytest tests/
+uv run ruff check src/
+```
+
+## License
+
+MIT

chat_sdk-0.0.1a4/README.md

@@ -0,0 +1,85 @@
+# chat-sdk-python
+
+Multi-platform async chat SDK for Python. Port of [Vercel Chat](https://github.com/vercel/chat).
+
+> **Status: Alpha (0.0.1a4)** — API may change. Not yet tested in production.
+
+## Why chat-sdk?
+
+- **Write once, deploy to 8 platforms.** One handler runs on Slack, Discord, Teams, Telegram, WhatsApp, Google Chat, GitHub, and Linear.
+- **Built-in concurrency primitives.** Deduplication, thread locking, and message queuing are handled for you.
+- **Cross-platform cards.** Author a `Card` once and it renders as Block Kit (Slack), Adaptive Cards (Teams), embeds (Discord), and more.
+- **Not a replacement for platform SDKs.** chat-sdk is built *on top of* them. You can always drop down to the native SDK when you need to.
+
+## Install
+
+```bash
+pip install chat-sdk                   # core only
+pip install chat-sdk[slack]            # + Slack adapter
+pip install chat-sdk[all]              # all adapters + state backends
+```
+
+## Quick Start
+
+```python
+from chat_sdk import Chat, Card, Button, Actions, MemoryStateAdapter
+from chat_sdk.adapters.slack import create_slack_adapter
+
+chat = Chat(
+    adapters={"slack": create_slack_adapter()},
+    state=MemoryStateAdapter(),
+    user_name="my-bot",
+)
+
+@chat.on_mention
+async def handle_mention(thread, message):
+    await thread.post(
+        Card(title="Hello!", children=[
+            Actions([Button(id="hi", label="Say Hi")])
+        ])
+    )
+```
+
+## Adapters
+
+| Platform | Install Extra | Status |
+|----------|--------------|--------|
+| Slack | `chat-sdk[slack]` | Alpha |
+| Discord | `chat-sdk[discord]` | Alpha |
+| Teams | `chat-sdk[teams]` | Alpha |
+| Telegram | `chat-sdk[telegram]` | Alpha |
+| WhatsApp | `chat-sdk[whatsapp]` | Alpha |
+| Google Chat | `chat-sdk[google-chat]` | Alpha |
+| GitHub | `chat-sdk[github]` | Alpha |
+| Linear | `chat-sdk[linear]` | Alpha |
+
+## State Backends
+
+| Backend | Install Extra |
+|---------|--------------|
+| In-Memory | Built-in |
+| Redis | `chat-sdk[redis]` |
+| PostgreSQL | `chat-sdk[postgres]` |
+
+## Compared to Alternatives
+
+| Feature | chat-sdk | Raw platform SDKs | BotFramework SDK |
+|---------|----------|--------------------|------------------|
+| Multi-platform from one codebase | 8 platforms | 1 per SDK | Teams + limited |
+| Async-native (Python 3.11+) | Yes | Varies | No |
+| Cross-platform cards | Card model | Platform-specific | Adaptive Cards only |
+| Thread locking / dedup | Built-in | DIY | DIY |
+| State abstraction (mem/redis/pg) | Built-in | DIY | DIY |
+| Drop down to native SDK | Yes | N/A | Partially |
+
+## Development
+
+```bash
+uv sync --group dev
+uv run pytest tests/
+uv run ruff check src/
+```
+
+## License
+
+MIT

chat_sdk-0.0.1a4/pyproject.toml

@@ -0,0 +1,74 @@
+[project]
+name = "chat-sdk"
+version = "0.0.1a4"
+description = "Multi-platform async chat SDK for Python — port of Vercel Chat"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.11"
+dependencies = []
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Framework :: AsyncIO",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Chat",
+    "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/Chinchill-AI/chat-sdk-python"
+Repository = "https://github.com/Chinchill-AI/chat-sdk-python"
+Issues = "https://github.com/Chinchill-AI/chat-sdk-python/issues"
+
+[project.optional-dependencies]
+slack = ["slack-sdk>=3.27.0"]
+github = ["pyjwt[crypto]>=2.8"]
+redis = ["redis>=5.0"]
+postgres = ["asyncpg>=0.29"]
+crypto = ["cryptography>=42.0"]
+discord = ["pynacl>=1.5", "aiohttp>=3.9"]
+teams = ["aiohttp>=3.9"]
+telegram = ["aiohttp>=3.9"]
+whatsapp = ["aiohttp>=3.9"]
+google-chat = ["aiohttp>=3.9", "google-auth>=2.0", "pyjwt>=2.8"]
+linear = ["aiohttp>=3.9"]
+all = [
+    "slack-sdk>=3.27.0",
+    "pyjwt[crypto]>=2.8",
+    "redis>=5.0",
+    "asyncpg>=0.29",
+    "cryptography>=42.0",
+    "pynacl>=1.5",
+    "aiohttp>=3.9",
+    "google-auth>=2.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/chat_sdk"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
+[tool.ruff]
+target-version = "py311"
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "SIM", "UP"]
+
+[dependency-groups]
+dev = [
+    "cryptography>=42.0",
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=5.0",
+    "ruff>=0.4.0",
+]